Compartir a través de


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

Establece el color de fondo de una lista de imágenes. Este método solo funciona si agrega un icono a la lista de imágenes o usa el método IImageList::AddMasked para agregar un mapa de bits blanco y negro. Sin una máscara, toda la imagen dibuja y el color de fondo no está visible.

Sintaxis

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

Parámetros

[in] clrBk

Tipo: COLORREF

Color de fondo que se va a establecer. Si este parámetro se establece en CLR_NONE, las imágenes se dibujan de forma transparente mediante la máscara.

[out] pclr

Tipo: COLORREF*

Puntero a un COLORREF que contiene el color de fondo anterior en la devolución si se ejecuta correctamente o CLR_NONE de lo contrario.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Para usar IImageList::SetBkColor, especifique Comctl32.dll versión 6 en el manifiesto. Para obtener más información sobre los manifiestos, consulte Habilitación de estilos visuales.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado commoncontrols.h
Archivo DLL Comctl32.dll (versión 6.0 o posterior)