BarItem.LargeImageIndex Property
Gets or sets the index of the large image which is displayed within the item’s link(s).
Namespace: DevExpress.XtraBars
Assembly: DevExpress.XtraBars.v19.2.dll
Declaration
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.LargeGlyph property.
If both the LargeImageIndex and BarItem.LargeGlyph properties are specified, then the actual image is specified by the BarItem.LargeGlyph property. In other words, the BarItem.LargeGlyph 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.LargeImageIndexDisabled property.
The BarItem.LargeGlyph and LargeImageIndex properties are in effect in the following cases:
- In a RibbonControl, when using the BarButtonItem, BarCheckItem, BarSubItem and BarLargeButtonItem items.
- In regular bar controls, when using the BarLargeButtonItem item.
- In regular bar controls and menus, when the use of large icons is activated using the BarManagerProperties.LargeIcons and/or BarManagerProperties.LargeIconsInMenu property.
- In sub-menus and popup menus, if the menu’s MenuDrawMode option is set to MenuDrawMode.LargeImagesText or MenuDrawMode.LargeImagesTextDescription. See BarCustomContainerItem.MenuDrawMode and PopupMenuBase.MenuDrawMode properties.