Bildlisten

Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Bildlisten verwendet werden.

Übersichten

Thema	Inhalte
Bildlisten	Eine Bildliste ist eine Sammlung von Bildern der gleichen Größe, auf die durch den Index verwiesen werden kann.

Functions

Thema	Inhalte
HIMAGELIST_QueryInterface	Ruft einen Zeiger auf ein IImageList- oder IImageList2-Objekt ab, das dem HIMAGELIST-Handle der Bildliste entspricht.
ImageList_Add	Fügt einer Bildliste ein Bild oder Bilder hinzu.
ImageList_AddMasked	Fügt einer Bildliste ein Bild oder Bilder hinzu, wodurch eine Maske aus der angegebenen Bitmap generiert wird.
ImageList_BeginDrag	Beginnt mit dem Ziehen eines Bilds.
ImageList_CoCreateInstance	Erstellt eine einzelne instance einer Imageliste und gibt einen Schnittstellenzeiger darauf zurück.
ImageList_Copy	Kopiert Bilder innerhalb einer bestimmten Bildliste.
ImageList_Create	Erstellt eine neue Imageliste.
ImageList_Destroy	Zerstört eine Bildliste.
ImageList_DragEnter	Zeigt das Bild an der angegebenen Position im Fenster an.
ImageList_DragLeave	Entsperrt das angegebene Fenster und blendet das Ziehbild aus, sodass das Fenster aktualisiert werden kann.
ImageList_DragMove	Verschiebt das Bild, das während eines Drag-and-Drop-Vorgangs gezogen wird. Diese Funktion wird in der Regel als Reaktion auf eine WM_MOUSEMOVE-Nachricht aufgerufen.
ImageList_DragShowNolock	Zeigt das gezogene Bild an oder blendet es aus.
ImageList_Draw	Zeichnet ein Bildlistenelement im angegebenen Gerätekontext.
ImageList_DrawEx	Zeichnet ein Bildlistenelement im angegebenen Gerätekontext. Die Funktion verwendet den angegebenen Zeichnungsstil und blendet das Bild mit der angegebenen Farbe.
ImageList_DrawIndirect	Zeichnet ein Bildlistenbild basierend auf einer IMAGELISTDRAWPARAMS-Struktur .
ImageList_Duplicate	Erstellt ein Duplikat einer vorhandenen Imageliste.
ImageList_EndDrag	Beendet einen Ziehvorgang.
ImageList_GetBkColor	Ruft die aktuelle Hintergrundfarbe für eine Bildliste ab.
ImageList_GetDragImage	Ruft die temporäre Bildliste ab, die für das Ziehen des Bilds verwendet wird. Die Funktion ruft auch die aktuelle Ziehposition und den Offset des Ziehbilds relativ zur Ziehposition ab.
ImageList_GetIcon	Erstellt ein Symbol aus einem Bild und eine Maske in einer Bildliste.
ImageList_GetIconSize	Ruft die Dimensionen von Bildern in einer Bildliste ab. Alle Bilder in einer Bildliste haben die gleichen Dimensionen.
ImageList_GetImageCount	Ruft die Anzahl der Bilder in einer Bildliste ab.
ImageList_GetImageInfo	Ruft Informationen zu einem Image ab
ImageList_LoadImage	Erstellt eine Bildliste aus der angegebenen Bitmap.
ImageList_Merge	Erstellt ein neues Image, indem zwei vorhandene Images kombiniert werden. Die Funktion erstellt auch eine neue Bildliste, in der das Bild gespeichert werden soll.
ImageList_Read	Liest eine Bildliste aus einem Stream.
ImageList_ReadEx	Liest eine Bildliste aus einem Stream und gibt eine Schnittstelle zur Bildliste zurück.
ImageList_Remove	Entfernt ein Bild aus einer Bildliste.
ImageList_Replace	Ersetzt ein Bild in einer Bildliste durch ein neues Image.
ImageList_ReplaceIcon	Ersetzt ein Bild durch ein Symbol oder einen Cursor.
ImageList_SetBkColor	Legt die Hintergrundfarbe für eine Bildliste fest. Diese Funktion funktioniert nur, wenn Sie ein Symbol hinzufügen oder ImageList_AddMasked mit einer schwarzweißen Bitmap verwenden. Ohne Maske wird das gesamte Bild gezeichnet; Daher ist die Hintergrundfarbe nicht sichtbar.
ImageList_SetColorTable	Legt die Farbtabelle für eine Bildliste fest.
ImageList_SetDragCursorImage	Erstellt ein neues Ziehbild, indem das angegebene Bild (in der Regel ein Mauscursorbild) mit dem aktuellen Ziehbild kombiniert wird.
ImageList_SetIconSize	Legt die Dimensionen von Bildern in einer Bildliste fest und entfernt alle Bilder aus der Liste.
ImageList_SetImageCount	Ändert die Größe einer vorhandenen Bildliste.
ImageList_SetOverlayImage	Fügt der Liste der Bilder, die als Überlagerungsmasken verwendet werden sollen, ein angegebenes Bild hinzu. Eine Bildliste kann bis zu vier Überlagerungsmasken in Version 4.70 und früher und bis zu 15 in Version 4.71 enthalten. Die Funktion weist dem angegebenen Bild einen Überlagerungsmaskenindex zu.
ImageList_Write	Schreibt eine Bildliste in einen Stream.
ImageList_WriteEx	Schreibt eine Bildliste in einen Stream.

Makros

Thema	Inhalte
ImageList_AddIcon	Fügt einer Bildliste ein Symbol oder Cursor hinzu. ImageList_AddIcon ruft die funktion ImageList_ReplaceIcon auf.
ImageList_ExtractIcon	Ruft die ImageList_GetIcon-Funktion auf, um ein Symbol oder einen Cursor basierend auf einem Bild und einer Maske in einer Bildliste zu erstellen.
ImageList_LoadBitmap	Ruft die ImageList_LoadImage-Funktion auf, um eine Bildliste aus der angegebenen Bitmapressource zu erstellen.
ImageList_RemoveAll	Ruft die ImageList_Remove-Funktion auf, um alle Bilder aus einer Bildliste zu entfernen.
INDEXTOOVERLAYMASK	Bereitet den Index einer Überlagerungsmaske so vor, dass die ImageList_Draw-Funktion sie verwenden kann.

Schnittstellen

Thema	Inhalte
IImageList	Macht Methoden verfügbar, die Bildlisten bearbeiten und mit ihnen interagieren. Um IImageList zu verwenden, geben Sie Comctl32.dll Version 6 im Manifest an. Wenn Sie dies nicht tun, wird Comctl32.dll Version 5 standardmäßig verwendet, mit der IImageList unvorhersehbares Verhalten anzeigen kann. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Methoden

Thema	Inhalte
Hinzufügen	Fügt einer Bildliste ein oder mehrere Bilder hinzu.
AddMasked	Fügt einer Bildliste ein Bild oder Bilder hinzu, wodurch eine Maske aus der angegebenen Bitmap generiert wird.
BeginDrag	Beginnt mit dem Ziehen eines Bilds.
Klon	Klont eine vorhandene Imageliste.
Kopieren	Kopiert Bilder aus einer angegebenen Bildliste.
DragEnter	Sperrt Updates für das angegebene Fenster während eines Ziehvorgangs und zeigt das Ziehbild an der angegebenen Position im Fenster an.
DragLeave	Entsperrt das angegebene Fenster und blendet das Ziehbild aus, sodass das Fenster aktualisiert werden kann.
DragMove	Verschiebt das Bild, das während eines Drag-and-Drop-Vorgangs gezogen wird. Diese Funktion wird in der Regel als Antwort auf eine WM_MOUSEMOVE-Nachricht aufgerufen.
DragShowNolock	Zeigt das zu ziehende Bild an oder blendet es aus.
Zeichnen	Zeichnet ein Bildlistenelement im angegebenen Gerätekontext.
EndDrag	Beendet einen Ziehvorgang.
GetBkColor	Ruft die aktuelle Hintergrundfarbe für eine Bildliste ab.
GetDragImage	Ruft die temporäre Bildliste ab, die für das Ziehen des Bilds verwendet wird. Die Funktion ruft auch die aktuelle Ziehposition und den Offset des Ziehbilds relativ zur Ziehposition ab.
GetIcon	Erstellt ein Symbol aus einem Bild und eine Maske in einer Bildliste.
GetIconSize	Ruft die Dimensionen von Bildern in einer Bildliste ab. Alle Bilder in einer Bildliste haben die gleichen Dimensionen.
GetImageCount	Ruft die Anzahl der Bilder in einer Bildliste ab.
GetImageInfo	Ruft Informationen zu einem Bild ab.
GetImageRect	Ruft das umgebende Rechteck eines Bilds ab.
GetItemFlags	Ruft die Flags eines Images ab.
GetOverlayImage	Ruft ein angegebenes Bild aus der Liste der Bilder ab, die als Überlagerungsmasken verwendet werden.
Merge	Erstellt ein neues Image, indem zwei vorhandene Images kombiniert werden. Mit dieser Methode wird auch eine neue Imageliste erstellt, in der das Image gespeichert werden soll.
Entfernen	Entfernt ein Bild aus einer Bildliste.
Replace	Ersetzt ein Bild in einer Bildliste durch ein neues Image.
ReplaceIcon	Ersetzt ein Bild durch ein Symbol oder einen Cursor.
SetBkColor	Legt die Hintergrundfarbe für eine Bildliste fest. Diese Methode funktioniert nur, wenn Sie der Bildliste ein Symbol hinzufügen oder die IImageList::AddMasked-Methode verwenden, um eine schwarzweiße Bitmap hinzuzufügen. Ohne Maske zeichnet das gesamte Bild, und die Hintergrundfarbe ist nicht sichtbar.
SetDragCursorImage	Erstellt ein neues Ziehbild, indem das angegebene Bild, das in der Regel ein Mauscursorbild ist, mit dem aktuellen Ziehbild kombiniert wird.
SetIconSize	Legt die Dimensionen von Bildern in einer Bildliste fest und entfernt alle Bilder aus der Liste.
SetImageCount	Ändert die Größe einer vorhandenen Bildliste.
SetOverlayImage	Fügt der Liste der Bilder, die als Überlagerungsmasken verwendet werden, ein angegebenes Bild hinzu. Eine Bildliste kann bis zu vier Überlagerungsmasken in Common Controls Version 4.70 und früher und bis zu 15 in Version 4.71 oder höher enthalten. Die -Methode weist dem angegebenen Bild einen Überlagerungsmaskenindex zu.

Strukturen

Thema	Inhalte
IMAGEINFO	Enthält Informationen zu einem Bild in einer Bildliste. Diese Struktur wird mit der IImageList::GetImageInfo-Funktion verwendet.
IMAGELISTDRAWPARAMS	Enthält Informationen zu einem Bildlistenzeichnungsvorgang und wird mit der Funktion IImageList::D raw verwendet.