Sft_SetPictureImageList
Store an image-list reference in a SFT_PICTURE as a SFT_PICTURE_IMAGELIST or SFT_PICTURE_IMAGELISTOVL (with overlay) slot.
C
void Sft_SetPictureImageList(LPSFT_PICTURE lpPicture, HIMAGELIST hImageList,
short iImage, short iImageDisabled);
void Sft_SetPictureImageListOvl(LPSFT_PICTURE lpPicture, HIMAGELIST hImageList,
short iImage, short iImageOverlay, short style);Parameters
lpPicture
Pointer to a SFT_PICTURE. Must not be NULL.
hImageList
Image list handle. NULL leaves the slot empty.
iImage
Index of the entry in hImageList drawn in the enabled state.
iImageDisabled
(Sft_SetPictureImageList only.) Index drawn in the disabled state. Set to -1 to reuse iImage - the system applies a generic graying effect at draw time.
iImageOverlay
(Sft_SetPictureImageListOvl only.) Index of the entry to draw as an overlay on top of iImage.
style
(Sft_SetPictureImageListOvl only.) Overlay style flags. Accepts SFT_IMAGEOVL_GHOSTED for a semi-transparent overlay. Use 0 for a solid composite.
Comments
Both setters call Sft_ClearPicture internally before assigning the new image-list reference.
Resource ownership: the application owns the HIMAGELIST and must keep it alive until the SFT_PICTURE is cleared or the host control is destroyed. Image lists shared between multiple SFT_PICTURE instances must outlive the last consumer.
See Also SftPicture2 | SFT_PICTURE | SFT_PICTURE_IMAGELIST | SFT_IMAGEOVL_GHOSTED | Sft_IsPictureImageList
On
Off