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. |