Skip to main content

Column Header

  • 2 minutes to read

Column headers identify columns in the tree list. All column headers are located in the column header panel.

A column header contains:

  • A caption string that identifies the column’s content.

  • A caption glyph that provides graphical information about the column’s content.

  • A sort glyph that identifies the sort order applied to the column’s values.

Columns can be moved within the tree list by dragging their headers, and can be resized by dragging header edges. Moving and sizing a column’s header or changing its visibility affects all data and summary cells that correspond to this column and automatically adjusts the column header panel’s height. You can prohibit columns from being resized or moved within the tree list, as well as prohibit bands from accepting columns of other bands.

The table below lists the main properties that relate to column headers.

Visibility

The TreeList control’s OptionsView.Headers property.

Position

A column’s Position property.

Appearance

The TreeList control’s Styles.ColumnHeader property, or a column’s Styles.Header property.

To dynamically customize style settings, handle the TreeList control’s Styles.OnGetColumnHeaderStyle event.

Use the TreeList control’s OptionsView.ExtPaintStyle property to customize the appearance of column headers when the UltraFlat style is applied to the control.

Custom Draw Event

The TreeList control’s OnCustomDrawHeaderCell event.

Contents

A column’s Caption.Text, Caption.Glyph, and SortOrder properties.

Behavior

The TreeList control’s OptionsCustomizing.ColumnCustomizing, OptionsCustomizing.ColumnHiding, OptionsCustomizing.ColumnHorzSizing, OptionsCustomizing.ColumnMoving, OptionsCustomizing.StackedColumns, OptionsCustomizing.ColumnsQuickCustomization, OptionsCustomizing.ColumnVertSizing, OptionsBehavior.Sorting, and OptionsBehavior.MultiSort properties.

A column’s Options property.

Size

The TreeList control’s OptionsView.ColumnAutoWidth and OptionsView.HeaderAutoHeight properties.

A column’s Position.LineCount and Width property.

Context Menu

Refer to the Column Header Context Menu topic.

Hints

The TreeList control’s OptionsBehavior.HeaderHints property.

A column’s StatusHint property.

HitTest Information

The TreeList control’s HitTest.HitAtColumnHeader property.