Método IImageList::SetBkColor (commoncontrols.h)

Define a cor da tela de fundo de uma lista de imagens. Esse método só funcionará se você adicionar um ícone à lista de imagens ou usar o método IImageList::AddMasked para adicionar um bitmap preto e branco. Sem uma máscara, toda a imagem desenha e a cor da tela de fundo não fica visível.

Sintaxe

HRESULT SetBkColor(
  [in]  COLORREF clrBk,
  [out] COLORREF *pclr
);

Parâmetros

[in] clrBk

Tipo: COLORREF

A cor da tela de fundo a ser definida. Se esse parâmetro for definido como CLR_NONE, as imagens serão desenhadas de forma transparente usando a máscara.

[out] pclr

Tipo: COLORREF*

Um ponteiro para um COLORREF que contém a cor anterior da tela de fundo no retorno se tiver êxito ou CLR_NONE caso contrário.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Para usar IImageList::SetBkColor, especifique Comctl32.dll versão 6 no manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

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	commoncontrols.h
DLL	Comctl32.dll (versão 6.0 ou posterior)