Skip to main content

TdxBar.Images Property

Specifies an image list that contains images for standard size (16 by 16 pixels) bar item controls or enlarged standard size buttons, located on the toolbar.

Declaration

property Images: TCustomImageList read; write;

Property Value

Type
TCustomImageList

Remarks

Normally, standard size bar item controls display images from an image list provided via a bar manager’s ImageOptions.Images property. You can associate any bar item with a specific image from this list via the item’s ImageIndex property. All item controls that correspond to this bar item will display the selected image. When a toolbar is dynamically populated with bar item controls, it’s easier to provide images for this particular toolbar via its own Images property, and make its item controls reference these images via a corresponding item link‘s ImageIndex property. If the item link’s ImageIndex property is assigned a negative value, the ImageIndex property of the corresponding bar item will be used instead.

Item images derived from the TdxBarWindowItem class are visible only when the bars in which they are displayed are docked to the left or right side of the parent window (the TdxBarFontNameCombo, TdxBarImageCombo, TdxBarTreeViewCombo, TdxBarDateCombo, TdxBarColorCombo, etc. – are displayed with their own images).

The following image illustrates a toolbar docked to the right side of a form. The toolbar contains two TdxBarButton items with images and a TdxBarColorCombo item with its own image.

A toolbar’s Images property is also in effect for enlarged standard size buttons located in this toolbar. You can specify which icons should be displayed by these buttons via a bar manager’s ImageOptions.UseLargeImagesForLargeIcons option. To provide images for large size (32 by 32 pixels) or hot-tracked item controls, use a bar manager’s ImageOptions.LargeImages or ImageOptions.HotImages property, respectively.

See Also