ImageList_Draw-Funktion (commctrl.h)
Zeichnet ein Bildlistenelement im angegebenen Gerätekontext.
Syntax
BOOL ImageList_Draw(
HIMAGELIST himl,
int i,
HDC hdcDst,
int x,
int y,
UINT fStyle
);
Parameter
himl
Typ: HIMAGELIST
Ein Handle für die Bildliste.
i
Typ: int
Der nullbasierte Index des zu zeichnenden Bilds.
hdcDst
Typ: HDC
Ein Handle für den Zielgerätekontext.
x
Typ: int
Die x-Koordinate, an der innerhalb des angegebenen Gerätekontexts gezeichnet werden soll.
y
Typ: int
Die y-Koordinate, an der innerhalb des angegebenen Gerätekontexts gezeichnet werden soll.
fStyle
Typ: UINT
Das Zeichenformat und optional das Überlagerungsbild. Informationen zum Angeben eines Überlagerungsbildindex finden Sie im Kommentarabschnitt am Ende dieses Themas. Dieser Parameter kann eine Kombination aus einem Überlagerungsbildindex und mindestens einem der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
|
|
Zeichnet das Bild und mischt 25 Prozent mit der Systemmarkierungsfarbe. Dieser Wert hat keine Auswirkung, wenn die Bildliste keine Maske enthält. |
|
Zeichnet das Bild und mischt 50 Prozent mit der Systemmarkierungsfarbe. Dieser Wert hat keine Auswirkung, wenn die Bildliste keine Maske enthält. |
|
|
|
Legen Sie dieses Flag fest, wenn für die Überlagerung keine Maske gezeichnet werden muss. Dieses Flag bewirkt , dass ImageList_DrawEx nur das Bild zeichnet und die Maske ignoriert. |
|
Zeichnet die Maske. |
|
Zeichnet das Bild mit der Hintergrundfarbe für die Bildliste. Wenn die Hintergrundfarbe der CLR_NONE Wert ist, wird das Bild transparent mit der Maske gezeichnet. |
|
|
|
Zeichnet das Bild mit der Maske transparent, unabhängig von der Hintergrundfarbe. Dieser Wert hat keine Auswirkung, wenn die Bildliste keine Maske enthält. |
Rückgabewert
Typ: BOOL
Gibt bei erfolgreicher Ausführung nonzero zurück, oder andernfalls null.
Hinweise
Ein Überlagerungsbild wird transparent über dem primären Bild gezeichnet, das im i-Parameter angegeben ist. Um ein Überlagerungsbild im fStyle-Parameter anzugeben, verwenden Sie das Makro INDEXTOOVERLAYMASK , um den einbasierten Index des Überlagerungsbilds zu verschieben. Verwenden Sie den OR-Operator, um den Rückgabewert des Makros logisch mit den Zeichenstilflags zu kombinieren, die im fStyle-Parameter angegeben sind. Sie müssen dieses Bild zunächst als Überlagerungsbild angeben, indem Sie die funktion ImageList_SetOverlayImage verwenden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | commctrl.h |
| Bibliothek | Comctl32.lib |
| DLL | Comctl32.dll |
| APIs | ext-ms-win-shell-comctl32-init-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393) |