Band Header
- 2 minutes to read
Band headers identify bands in the tree list. All band headers are located in the band header panel.
Bands can be moved within the tree list by dragging their headers and can be resized by dragging header edges. Moving and sizing a band’s header or changing its visibility affects all its columns and child bands and automatically adjusts the band header panel’s height. You can prohibit bands from being resized or moved within the tree list.
The table below lists the main properties that relate to band headers.
Visibility | The TreeList control’s OptionsView.Bands property. |
Position | A band’s Position property. |
Appearance | The TreeList control’s Styles.BandHeader or a band’s Styles.Header property. To dynamically customize these style settings, handle the TreeList control’s Styles.OnGetBandHeaderStyle event. Use the TreeList control’s OptionsView.ExtPaintStyle property to customize the appearance of band headers when the UltraFlat style is applied to the TreeList control. |
Custom Draw Event | The TreeList control’s OnCustomDrawBandHeaderCell event. |
Contents | A band’s Caption property. |
Behavior | The TreeList control’s OptionsCustomizing.BandCustomizing, OptionsCustomizing.BandHiding, OptionsCustomizing.BandHorzSizing, OptionsCustomizing.BandMoving, OptionsCustomizing.BandsQuickCustomization, OptionsCustomizing.BandVertSizing, and OptionsCustomizing.NestedBands properties. A band’s Options, FixedKind, and Expandable properties. |
Size | The TreeList control’s OptionsView.BandLineHeight property. A band’s Width property. |
Hints | The TreeList control’s OptionsBehavior.HeaderHints property. |
HitTest Information | The TreeList control’s HitTest.HitAtBandHeader property. |