TdxBarItem.ImageIndex Property

Specifies the image that is displayed when the item’s link represents a standard size (16 by 16 pixels) item control or enlarged standard size button.

Declaration

property ImageIndex: Integer read; write; default -1;

Property Value

Type
Integer

Remarks

Use this property to associate all bar item controls that correspond to the current item with an image from a bar manager’s ImageOptions.Images or ImageOptions.LargeImages property (see details below). If you provided a separate image collection for individual toolbars, Ribbon Mini Toolbars, submenus, or popup menus via their Images property, item controls located on them use a bar item link’s ImageIndex property to reference images from this collection. If the item link’s ImageIndex property is not specified (i.e., assigned a negative value), the bar item’s ImageIndex property is used instead.

The specified image is displayed, provided that the item Glyph property is unassigned.

Note

The specified image is also used for enlarged standard size buttons if the following conditions are met:

• Large icons are not assigned to these buttons via their LargeGlyph and LargeImageIndex properties;

• A bar manager’s ImageOptions.UseLargeImagesForLargeIcons option is disabled.

The default value of the ImageIndex property is -1.