Returns or sets the AImageList control to be used for storing images displayed when a button is in a disabled state.
Object.DisabledImageList [ = ppDisabledImageList ]
The DisabledImageList property syntax has the following parts:
|
Name |
Type |
Description |
|
Object |
AToolBar |
AToolBar control |
|
ppDisabledImageList |
AImageList |
AImageList object |
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 Name.
Setting the AToolbar control's Enabled property to False will not cause the images contained by the DisabledImageList to display. Instead, set the Button object's Enabled property is set to False to display an image from the DisabledImageList.
Note: The images in the AImageList control assigned to the DisabledImageList property must be the same size as the images in the AImageList control assigned to the ImageList property.
The following statement sets the AImageList control to be used for storing images displayed when an AToolBarButton is in a disabled state to imglDisable:
tbr1.DisabledImageList=imglDisable