Quick Band Customization Button

• Aug 07, 2024
• 2 minutes to read

The Quick Band Customization button is displayed at the intersection of the band header panel and the 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. In addition, users can drag items in the dropdown to reorder the associated bands.

To select multiple items in the dropdown, users can:

• Hold down the Shift key and click items.

• Press and hold the left mouse button and move the mouse pointer over items. Hold down the Shift key while moving the mouse pointer if item reordering is enabled.

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

Feature	Related Members
Visibility	The View’s OptionsCustomize.BandsQuickCustomization property. Note that setting this property to True results in enabling the indicator.
Dropdown List’s Content	The dropdown list displays all bands whose VisibleForCustomization property is set to True. You can customize the caption of bands displayed in the dropdown via their AlternateCaption property. Use the View’s OptionsCustomize.BandsQuickCustomizationShowCommands property to switch the visibility of the (All) and (Sorted) check boxes.
Appearance	The Quick Band Customization button is an indicator cell.
Dropdown List’s Layout	You can constrain the dropdown’s height using the View’s OptionsCustomize.BandsQuickCustomizationMaxDropDownCount property.
Behavior	The Quick Band Customization dropdown allows users to: Change the visible state of bands without using the Customization Form at runtime or the Object Inspector at design time; Reorder bands in a View by dragging their names in the dropdown. Use the View’s OptionsCustomize.BandsQuickCustomizationReordering property to enable this functionality. It is always enabled at design time.