Freigeben über


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.