ImageList_SetColorTable-Funktion
Legt die Farbtabelle für eine Bildliste fest.
Syntax
int ImageList_SetColorTable(
_In_ HIMAGELIST himl,
_In_ int start,
_In_ int len,
_In_ RGBQUAD *prgb
);
Parameter
-
himl [in]
-
Typ: HIMAGELIST
Ein Handle für die Bildliste.
-
start [in]
-
Typ: int
Ein nullbasierter Farbtabellenindex, der den ersten festzulegenden Farbtabelleneintrag angibt.
-
len [in]
-
Typ: int
Die Anzahl der festzulegenden Farbtabelleneinträge.
-
prgb [in]
-
Typ: RGBQUAD*
Ein Zeiger auf ein Array von lenRGBQUAD-Strukturen , die neue Farbinformationen für die Farbtabelle des DIB enthalten.
Rückgabewert
Typ: int
Wenn die Funktion erfolgreich ist, gibt sie die Anzahl der von der Funktion festgelegten Farbtabelleneinträge zurück. Wenn die Funktion fehlschlägt, ist der Rückgabewert kleiner oder gleich 0.
Bemerkungen
Nur Bildlisten, die mit dem ILC_COLOR4 - oder ILC_COLOR8-Flag erstellt wurden, weisen Farbtabellen auf. Die Farbtabelle einer solchen Bildliste wird in der Regel automatisch festgelegt, indem die Farbtabelle des ersten Bilds kopiert wird, das der Liste hinzugefügt wurde (z. B. über die ImageList_Add-Funktion ), wenn es sich bei diesem Bild um ein DIB handelt. Wenn das erste Der Bildliste hinzugefügte Bild kein DIB ist, wird die Farbtabelle der Halbtonpalette für ILC_COLOR8 Bildlisten und die VGA-Farbtabelle für ILC_COLOR4 verwendet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| DLL |
|