Image Overlays in Image Lists
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at Image Overlays in Image Lists.
Every image list (CImageList) includes a list of images to use as overlay masks. An "overlay mask" is an image drawn transparently over another image. Any image can be used as an overlay mask. You can specify up to four overlay masks per image list.
You add the index of an image to the list of overlay masks by using the SetOverlayImage member function, the index of an image, and the index of an overlay mask. Note that the indices for the overlay masks are one-based rather than zero-based.
You draw an overlay mask over an image using a single call to Draw. The parameters include the index of the image to draw and the index of an overlay mask. You must use the INDEXTOOVERLAYMASK macro to specify the index of the overlay mask. You can also specify an overlay image when calling the DrawIndirect member function.