TCustomdxBarSubItem.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 in the submenu.

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 submenu is dynamically populated with bar item controls, it’s easier to provide images for this particular submenu 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.

A submenu’s Images property is also in effect for enlarged standard size buttons located in this submenu. 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) item controls, use a bar manager’s ImageOptions.LargeImages property.

If a submenu’s Images property is not assigned, the submenu searches its parents (toolbars, menus, or submenus) for an image list assigned to their Images property to be used, starting from the immediate parent. If none of the parents have the Images property assigned, an image list assigned to a bar manager’s ImageOptions.Images property is used instead.