Funktion _ "ImageList SetColorTable"
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 festgelegten Farbtabelleneintrag angibt.
-
len [ In]
-
Typ: int
Die Anzahl der festgelegten Farbtabelleneinträge.
-
prgb [ In]
-
Typ: RGBQUAD*
Ein Zeiger auf ein Array von len RGBQUAD-Strukturen, die neue Farbinformationen für die Farbtabelle des DIB enthalten.
Rückgabewert
Typ: int
Wenn die Funktion erfolgreich ist, gibt sie die Anzahl von Farbtabelleneinträgen zurück, die von der Funktion festgelegt wurden. Wenn die Funktion fehlschlägt, ist der Rückgabewert kleiner oder gleich 0 (null).
Hinweise
Nur Bildlisten, die mit dem ILC _ COLOR4- oder ILC _ COLOR8-Flag erstellt wurden, verfügen über Farbtabellen. 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 Funktion ImageList _ Add), wenn es sich bei dem 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 Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| DLL |
|