ImageList_SetBkColor function

Sets the background color for an image list. This function only works if you add an icon or use ImageList_AddMasked with a black and white bitmap. Without a mask, the entire image is drawn; hence the background color is not visible.

Syntax

COLORREF ImageList_SetBkColor(
  _In_ HIMAGELIST himl,
  _In_ COLORREF   clrBk
);

Parameters

himl [in]

Type: HIMAGELIST

A handle to the image list.

clrBk [in]

Type: COLORREF

The background color to set. This parameter can be the CLR_NONE value; in that case, images are drawn transparently using the mask.

Return value

Type: COLORREF

Returns the previous background color if successful, or CLR_NONE otherwise.

Requirements