Share via

ImageList_Draw-Funktion (commctrl.h)

  • Artikel

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
ILD_BLEND
ILD_BLEND25
 Zeichnet das Bild und mischt 25 Prozent mit der Systemmarkierungsfarbe. Dieser Wert hat keine Auswirkung, wenn die Bildliste keine Maske enthält.
ILD_BLEND50
 Zeichnet das Bild und mischt 50 Prozent mit der Systemmarkierungsfarbe. Dieser Wert hat keine Auswirkung, wenn die Bildliste keine Maske enthält.
ILD_FOCUS
ILD_IMAGE
 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.
ILD_MASK
 Zeichnet die Maske.
ILD_NORMAL
 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.
ILD_SELECTED
ILD_TRANSPARENT
 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)