Skip to main content
Bar

RibbonGalleryBarItem.GalleryCustomDrawItemImage Event

Enables images of gallery items to be painted manually.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DXCategory("Events")]
public event GalleryItemCustomDrawEventHandler GalleryCustomDrawItemImage

Event Data

The GalleryCustomDrawItemImage event's data class is GalleryItemCustomDrawEventArgs. The following properties provide information specific to this event:

Property Description
Bounds Gets the bounding rectangle of the Gallery item currently being painted.
Cache Gets an object which specifies the storage for the most used pens, fonts and brushes.
Gallery Gets the Gallery that contains the processed Gallery item. Inherited from GalleryItemEventArgs.
Handled Gets or sets whether an event was handled. If it was handled default painting isn’t required.
InRibbonGalleryLink For In-Ribbon galleries, gets the bar item link that displays the current gallery. Inherited from GalleryItemEventArgs.
Item Gets the Gallery item currently being processed. Inherited from GalleryItemEventArgs.
ItemInfo Gets the information which is required to paint a Gallery item.

The event data class exposes the following methods:

Method Description
DrawHtml(HtmlTemplate, DxHtmlPainterContext, Action<DxHtmlPainterArgs>) Paints the required HTML template inside an element that raised this event. The context parameter allows you to assign an object that transfers mouse events to template elements.
DrawHtml(HtmlTemplate, Action<DxHtmlPainterArgs>) Paints the required HTML template inside an element that raised this event.

Remarks

This event is equivalent to the BaseGallery.CustomDrawItemImage event of the RibbonGalleryBarItem.Gallery object. See the BaseGallery.CustomDrawItemImage topic for more information.

See Also