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.v14.2.dll

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.

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 when clicked, 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.