IImageList::SetBkColor-Methode (commoncontrols.h)

  • Artikel

Legt die Hintergrundfarbe für eine Bildliste fest. Diese Methode funktioniert nur, wenn Sie der Bildliste ein Symbol hinzufügen oder die IImageList::AddMasked-Methode verwenden, um eine schwarzweiße Bitmap hinzuzufügen. Ohne Maske zeichnet das gesamte Bild, und die Hintergrundfarbe ist nicht sichtbar.

Syntax

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

Parameter

[in] clrBk

Typ: COLORREF

Die festzulegende Hintergrundfarbe. Wenn dieser Parameter auf CLR_NONE festgelegt ist, zeichnen Bilder transparent mit der Maske.

[out] pclr

Typ: COLORREF*

Ein Zeiger auf eine COLORREF , die bei der Rückgabe bei erfolgreicher Rückgabe die vorherige Hintergrundfarbe enthält, oder CLR_NONE andernfalls.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Um IImageList::SetBkColor zu verwenden, geben Sie Comctl32.dll Version 6 im Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commoncontrols.h
DLL Comctl32.dll (Version 6.0 oder höher)