Compartilhar via


função ImageList_SetBkColor (commctrl.h)

Define a cor da tela de fundo de uma lista de imagens. Essa função só funcionará se você adicionar um ícone ou usar ImageList_AddMasked com um bitmap preto e branco. Sem uma máscara, toda a imagem é desenhada; portanto, a cor da tela de fundo não está visível.

Sintaxe

COLORREF ImageList_SetBkColor(
  [in] HIMAGELIST himl,
  [in] COLORREF   clrBk
);

Parâmetros

[in] himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens.

[in] clrBk

Tipo: COLORREF

A cor da tela de fundo a ser definida. Esse parâmetro pode ser o valor CLR_NONE; Nesse caso, as imagens são desenhadas de forma transparente usando a máscara.

Retornar valor

Tipo: COLORREF

Retorna a cor da tela de fundo anterior se tiver êxito ou CLR_NONE caso contrário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commctrl.h
Biblioteca Comctl32.lib
DLL Comctl32.dll