Skip to main content

PopupGalleryEditGallery.ItemCheckMode Property

Gets or sets the mode that specifies how gallery items can be selected.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

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.

See Also