Skip to main content

TdxGalleryControlOptionsBehavior.ItemMultiSelectKind Property

Specifies the manner in which end-users can modify the item selection.

Declaration

property ItemMultiSelectKind: TdxGalleryItemMultiSelectKind read; write; default imskGallery;

Property Value

Type Default
TdxGalleryItemMultiSelectKind imskGallery

Remarks

This property is especially useful when multiple items can be selected in the gallery control (the ItemCheckMode property is set to icmMultiple).

Options include:

Value

Description

imskListView

The gallery control mimics the item selection behavior found in standard list views. End-users can do the following to modify the selection:

  • Click an item or press arrow keys while holding down the Shift key to select a range of items;

  • Click an item while holding down the Ctrl key or press the Space key to select/deselect non-contiguous items.

  • Move focus to an item using arrow keys or click/right-click it to clear the selection and select this item. Clicking/right-clicking the currently selected item does not toggle its selected state;

  • Click/right-click a group caption or any area that is free from items to clear the selection.

imskGallery

Pressing the Space key or clicking an item switches its selected state. Moving focus does not clear the selection. Holding down the Shift or Ctrl key has no effect. Right-clicking an item that is currently not selected adds it to the selection. Right-clicks combined with the Shift or Ctrl key do not change the selection.

Each change to an item’s selected state fires the gallery control’s OnItemClick event. Clearing the selection sequentially deselects all the currently selected items by toggling their selected state, and as a result, fires the event for each of them.

Note

Right-clicks are ignored if the SelectOnRightClick property is set to False.

The default value of the ItemMultiSelectKind property is imskGallery.

See Also