HotImageList Property (AToolBar)

Returns or sets the AImageList control to be used for storing images displayed when a button is in a hot state.

Syntax

Object.HotImageList [ = obHotImageList ]

The HotImageList property syntax has the following parts:

 

Name

Type

Description

Object

AToolBar

AToolBar control

obHotImageList

AImageList

The AImageList control to be used for storing images displayed when a button is in a hot state.

Comments

The HotImageList property is used for "hot" images, that is, images which appear when the cursor hovers over a clickable spot and the Style property is set to atbrStyleTransparent.

The AToolBarButton object can display only one image for each button. At run time, it first determines how the button should be drawn (that is, normal, 'hot', or disabled) and then uses the image from the appropriate image list (ImageList, DisabledImageList or HotImageList) using the sole Image property as the key. It is important to understand that related images in each of the three image lists must be consistently named so that the AToolbar control pulls the correct ones. For example, if a particular button is making use of all three image types, then each of the three images must be defined in their respective image lists to have either the same Index as the other two or the same Key.

Example

The following statement returns the AImageList control to be used for storing images displayed when an AToolBarButton is in a hot state:

stbr1HotImageList=tbr1.HotImageList

Applies to

AToolBar

See Also

DisabledImageList, ImageList