Skip to main content

Band Header

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.