IImageList ::SetBkColor, méthode (commoncontrols.h)

Définit la couleur d’arrière-plan d’une liste d’images. Cette méthode fonctionne uniquement si vous ajoutez une icône à la liste d’images ou si vous utilisez la méthode IImageList ::AddMasked pour ajouter une bitmap en noir et blanc. Sans masque, l’image entière dessine et la couleur d’arrière-plan n’est pas visible.

Syntaxe

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

Paramètres

[in] clrBk

Type : COLORREF

Couleur d’arrière-plan à définir. Si ce paramètre est défini sur CLR_NONE, les images dessinent en toute transparence à l’aide du masque.

[out] pclr

Type : COLORREF*

Pointeur vers un COLORREF qui contient la couleur d’arrière-plan précédente en cas de réussite, ou CLR_NONE dans le cas contraire.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Pour utiliser IImageList ::SetBkColor, spécifiez Comctl32.dll version 6 dans le manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commoncontrols.h
DLL	Comctl32.dll (version 6.0 ou ultérieure)