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
Comctl32.dll (Version 3.51 oder höher)

Weitere Informationen

Farbtabelle