Skip to main content

TdxRibbonGalleryGroupItem.OnClick Event

Allows implementation of the gallery item‘s functionality.

Declaration

property OnClick: TNotifyEvent read; write;

Remarks

This event fires in response to clicking the gallery item or activating its functionality via the keyboard (using KeyTips, for instance).

Note that the event generation is dependant upon an item’s enabled state and a selection mode (see a gallery item’s Enabled property and a gallery’s Options.ItemSelectionMode property). It meets the following conditions:

Mode

Condition

gsmNone

The event fires in response to clicking a gallery item.

It is not generated, if an item is selected or deselected programmatically.

gsmSingle or gsmSingleInGroup

The event fires in the following cases:

  • If an item is selected or deselected by an end-user (the item can be deselected by an end-user in this mode, if the gallery’s Options.ItemAllowDeselect option is enabled.

  • If the currently selected item becomes inactive due to the other item selection performed by an end-user or via code.

  • If an item is selected programmatically.

gsmMultiple

The event fires if an item is selected or deselected by an end-user or programmatically.

To respond to mouse events for enabled items, handle the OnMouseDown, OnMouseUp, and OnMouseMove events.

See Also