ImageList_DrawEx-Funktion (commctrl.h)

Zeichnet ein Bildlistenelement im angegebenen Gerätekontext. Die Funktion verwendet den angegebenen Zeichnungsstil und blendet das Bild mit der angegebenen Farbe.

Syntax

BOOL ImageList_DrawEx(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  int        dx,
  int        dy,
  COLORREF   rgbBk,
  COLORREF   rgbFg,
  UINT       fStyle
);

Parameter

himl

Typ: HIMAGELIST

Ein Handle für die Bildliste

i

Typ: int

Der 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.

dx

Typ: int

Die Breite des zu zeichnenden Bildteils relativ zur linken oberen Ecke des Bilds. Wenn dx und dy null sind, zeichnet die Funktion das gesamte Bild. Die Funktion stellt nicht sicher, dass die Parameter gültig sind.

dy

Typ: int

Die Höhe des zu zeichnenden Bildteils relativ zur linken oberen Ecke des Bilds. Wenn dx und dy null sind, zeichnet die Funktion das gesamte Bild. Die Funktion stellt nicht sicher, dass die Parameter gültig sind.

rgbBk

Typ: COLORREF

Die Hintergrundfarbe des Bilds. Dieser Parameter kann ein anwendungsdefinierter RGB-Wert oder einer der folgenden Werte sein:

Wert	Bedeutung
CLR_NONE	Keine Hintergrundfarbe. Das Bild wird transparent gezeichnet.
CLR_DEFAULT	Die Standardhintergrundfarbe. Das Bild wird mit der Hintergrundfarbe der Bildliste gezeichnet.

rgbFg

Typ: COLORREF

Die Vordergrundfarbe des Bilds. Dieser Parameter kann ein anwendungsdefinierter RGB-Wert oder einer der folgenden Werte sein:

Wert	Bedeutung
CLR_NONE	Keine Mischfarbe. Das Bild wird mit der Farbe des Zielgerätekontexts gemischt.
CLR_DEFAULT	Die Standardfarbe des Vordergrunds. Das Bild wird mit der Hervorhebungsfarbe des Systems als Vordergrundfarbe gezeichnet.

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 von rgbFg angegebenen Mischfarbe. Dieser Wert hat keine Auswirkung, wenn die Bildliste keine Maske enthält.
ILD_BLEND50	Zeichnet das Bild und mischt 50 Prozent mit der von rgbFg angegebenen Mischfarbe. 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