Skip to main content

TdxBarImageOptions.Images Property

Specifies the image list that contains images for standard size (16 by 16 pixels) bar item controls.

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 this 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 bar item container (a toolbar, submenu, popup menu, radial menu, or Ribbon Mini Toolbar) is dynamically populated with item controls, it’s easier to provide images for this particular container 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 dxBarFontNameCombo, dxBarImageCombo, dxBarTreeViewCombo, dxBarDateCombo, dxBarColorCombo, etc. – are displayed with their own images).

In the following image a toolbar docked to the right side of a form is displayed. It contains two dxBarButton items with images and a dxBarColorCombo item with its own image.

To provide images for large size (32 by 32 pixels) item controls, use the LargeImages property. To provide images for hot-tracked large buttons, use the HotImages property. To specify which icons should be displayed for enlarged standard size buttons, use the UseLargeImagesForLargeIcons option.

See Also