Skip to main content

Quick Band Customization Button

  • 2 minutes to read

The Quick Band Customization button is displayed at the intersection of the band header panel and the node indicator. Users can click this button to invoke the Quick Band Customization dropdown that displays band captions in a checklist. A click on a band caption or a check box next to it allows users to change the band’s visibility both at design and runtime, without a switch to the Customization Form, Component Editor, or Object Inspector.

VCL Tree List: A Quick Band Customization Button

To select multiple items in the dropdown, users can:

  • Press and hold the left mouse button and move the mouse pointer over items.

  • Hold down the Shift key and click items.

  • Use the Shift+Up Arrow or Shift+Down Arrow key combination.

  • Hold down the Ctrl key with any of the above methods to invert selection and thus select non-contiguous items.

Users can press the Space key to toggle the checked state of selected items.

The table below lists the main properties that relate to the Quick Band Customization button.

Visibility

The TreeList control’s OptionsCustomizing.BandsQuickCustomization property.

Appearance

The Quick Band Customization button is an indicator cell. Refer to the Node Indicator topic for information on customizing indicator cells’ appearance.

Dropdown List Content

The dropdown list displays all bands whose Options.Hidden property value is False.

Use the TreeList control’s OptionsCustomizing.BandsQuickCustomizationShowCommands property to switch the visibility of the (All) and (Sorted) check boxes.

Dropdown List Layout

Use the TreeList control’s OptionsCustomizing.BandsQuickCustomizationMaxDropDownCount property to constrain the dropdown’s height.

HitTest Information

The TreeList control’s HitTest.HitAtBandCustomizing property.