Skip to main content
Bar

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DefaultValue(-1)]
[ImageList("LargeImages")]
public virtual int LargeImageIndexHot { get; set; }

#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