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

BarItem.LargeImageIndex Property

Gets or sets the index of the large image which is displayed within the item’s link(s). This property is obsolete. Use the BarItem.ImageOptions.LargeImageIndex property instead.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public virtual int LargeImageIndex { get; set; }

#Property Value

Type Description
Int32

An integer value that specifies the zero-based index of the large image within the source collection.

#Remarks

The LargeImageIndex property specifies the index of a large image in the collection of large images. If you are using regular DevExpress bar controls, the source of large images is specified by the BarManager.LargeImages property. In a RibbonControl, the source of large images is specified by the RibbonControl.LargeImages property.

A large bar item image can also be specified using the BarItem.ImageOptions.LargeImage property.

If both the LargeImageIndex and BarItem.ImageOptions.LargeImage properties are specified, then the actual image is specified by the BarItem.ImageOptions.LargeImage property. In other words, the BarItem.ImageOptions.LargeImage property takes priority over the LargeImageIndex property.

If it is necessary to specify an image that corresponds to the disabled state of a link, use the BarItem.LargeGlyphDisabled or BarItem.ImageOptions.DisabledLargeImageIndex property.

The BarItem.ImageOptions.LargeImage and LargeImageIndex properties are in effect in the following cases:

See Also