IImageList::SetBkColor-Methode (commoncontrols.h)

Artikel
02/24/2024

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)

Freigeben über