Gallery.ItemCheckMode Property

Gets or sets whether the item checking feature is enabled, and whether single or multiple items can be checked simultaneouly. This is a dependency property.

Namespace: DevExpress.Xpf.Bars

Assembly: DevExpress.Xpf.Core.v24.2.dll

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

public GalleryItemCheckMode ItemCheckMode { get; set; }

VB.NET

Public Property ItemCheckMode As GalleryItemCheckMode

Property Value

Type	Description
GalleryItemCheckMode	A GalleryItemCheckMode value that specifies item checking mode.

Available values:

Name	Description
None	The item checking feature is disabled.
Single	A single gallery item can be checked within a gallery at one time. Checking another gallery item unchecks the previously checked item.
Multiple	Multiple items can be checked within a gallery simultaneously. Clicking one item doesn’t uncheck other checked items.
SingleInGroup	A single gallery item can be checked within each gallery group.

Remarks

If the ItemCheckMode property is set to GalleryItemCheckMode.None, the item checking feature is disabled. In this mode, a gallery item behaves like a regular button on clicking, where it fires the Click events (GalleryItem.Click and Gallery.ItemClick).

In other modes, the item checking feature is enabled. The items are checked differently in these modes:

• GalleryItemCheckMode.Single mode

  A single gallery item can be checked within the gallery at one time. Checking another gallery item unchecks the previously checked item.

• GalleryItemCheckMode.SingleInGroup mode

  A single gallery item can be checked within each gallery group.

• GalleryItemCheckMode.Multiple mode

  Multiple items can be checked within the gallery simultaneously. Clicking one item doesn’t uncheck other checked items.

To get and set a gallery item’s check state in code, use the GalleryItem.IsChecked property.

When an item is checked, the GalleryItem.Checked and Gallery.ItemChecked events fire. Unchecking the item fires the GalleryItem.Unchecked and Gallery.ItemUnchecked events. To respond to checking and unchecking an item using a single event, use GalleryItem.Click or Gallery.ItemClick.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ItemCheckMode property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

wpf-create-a-ribboncontrol/CS/RibbonControl_Ex/MainWindow.xaml#L212

<dxb:Gallery MinColCount="1" ColCount="5"
 ItemCheckMode="Single"
 IsGroupCaptionVisible="False"

create-wpf-gallery-control/CS/GalleryControl_Ex/MainWindow.xaml#L17

<dxb:Gallery ColCount="2"
     ItemCheckMode="None"
     IsGroupCaptionVisible="True"