PopupGalleryEditGallery.ItemCheckMode Property
Gets or sets the mode that specifies how gallery items can be selected.
Namespace: DevExpress.XtraEditors
Assembly: DevExpress.XtraBars.v19.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.