Specifies the Image Control that contains the overlay image (if any) used by an item. If this attribute is not set to NULL-HANDLE, the image handle specified must refer to an image from the parent control's image list, as specified by its IMAGE-LIST attribute value. An image control referenced by this attribute must be an overlay image (i.e., must have the "O" STYLE).
If the referenced image control contains more than one image, the image used is determined by the item's OVERLAY-INDEX attribute value.
An overlay image is a image that is superimposed on the item's base image. Since they belong to the same image list, the base and overlay images have the same dimensions. However, the transparent pixels of the overlay image allow the corresponding pixels in the base image to show through. For more information, please refer to the article Working with Image List Controls.
Applies to | List view item, tree view item. |
---|---|
Data Type | HANDLE |
Default Value | NULL-HANDLE |
Possible Values | NULL-HANDLE / handle value of image. |