PopupGalleryEditGallery.ItemCheckMode Property
Gets or sets the mode that specifies how gallery items can be selected.
Namespace: DevExpress.XtraEditors
Assembly: DevExpress.XtraBars.v24.2.dll
Declaration
[DefaultValue(ItemCheckMode.SingleCheck)]
public override ItemCheckMode ItemCheckMode { get; set; }
Property Value
Type | Default | Description |
---|---|---|
ItemCheckMode | SingleCheck | The ItemCheckMode value that specifies how gallery items can be selected. |
Available values:
Name | Description |
---|---|
None | An item is not automatically checked on clicking. |
SingleCheck | Only a single item can be checked throughout the gallery. When checking another item, the previously checked item is unchecked. A checked item can be unchecked when clicking on it again. |
SingleRadio | The same as the ItemCheckMode.SingleCheck option, except the following: A checked item is NOT unchecked when clicking on it again. |
Multiple | Multiple items can be checked , by clicking them while holding the CTRL/SHIFT key. |
SingleCheckInGroup | An end-user can check a single item within each group. When checking another item, the previously checked item in the same group is unchecked. A checked item can be unchecked when clicking on it again. |
SingleRadioInGroup | The same as the ItemCheckMode.SingleCheckInGroup option, except the following: A checked item is NOT unchecked when clicking on it again. |
MultipleInGroup | Multiple items can be checked, but only within a single group. Checking any item within another group, unchecks items in the previous group. To select multiple items, click them while holding the CTRL/SHIFT key. |
Remarks
Using the ItemCheckMode property you can specify whether multiple item selection is enabled, and how gallery items can be checked. This property overrides the base BaseGallery.ItemCheckMode property to specify a different default value.
If single item selection is enabled, you can allow an end-user to close the PopupGalleryEdit popup window on a gallery item click. To accomplish this, set the PopupGalleryEditGallery.CloseOnItemClick property to true and the RepositoryItemPopupGalleryEdit.ShowButtons property to false.
If multiple selection is enabled, it is recommended that you save/discard the current selection by clicking the OK and Cancel buttons embedded in the popup window. The visibility of these buttons is specified by the RepositoryItemPopupGalleryEdit.ShowButtons property.