Bar

BarLargeButtonItem.LargeImageIndexHot Property

Gets or sets the index of the large image displayed within associated links when they are hot-tracked.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

[DefaultValue(-1)]
[ImageList("LargeImages")]
public virtual int LargeImageIndexHot { get; set; }
<DefaultValue(-1)>
<ImageList("LargeImages")>
Public Overridable Property LargeImageIndexHot As Integer

Property Value

Type Default Description
Int32

-1

An integer value specifying the zero-based index of the large image displayed within hot-tracked links.

Remarks

Use the LargeImageIndexHot property to specify the large image by its index within the BarManager.LargeImages collection. If a value assigned to this property is either negative or exceeds the maximum available index, images are hot-tracked by increasing their color saturation. Note that large images are only used by links that reside within toolbars. If a link is located in a sub-menu, it uses small images.

You can also specify the hot-tracked large image using the BarLargeButtonItem.LargeGlyphHot property. Please refer to this property description for details on the interaction of the LargeImageIndexHot and BarLargeButtonItem.LargeGlyphHot properties.

The image below displays a portion of a toolbar with a link in normal and hot-tracked states. Custom image for the hot-tracked state is not assigned.

LinkImages - LargeHotStandard

The following image displays the same toolbar but with a custom hot-tracked image assigned to the link.

LinkImages - LargeHotCustom

See Also