Freigeben über

Bildlisten

  • Artikel

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

Überblicke

Thema Inhalt
Bildlisten Eine Bildliste ist eine Sammlung von Bildern derselben Größe, auf die jeder durch seinen Index verwiesen werden kann.

Funktionen

Thema Inhalt
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, wobei eine Maske aus der angegebenen Bitmap generiert wird.
ImageList_BeginDrag Beginnt mit dem Ziehen eines Bilds.
ImageList_CoCreateInstance Erstellt eine einzelne Instanz einer Bildliste und gibt einen Schnittstellenzeiger darauf zurück.
ImageList_Copy Kopiert Bilder in einer bestimmten Bildliste.
ImageList_Create Erstellt eine neue Bildliste.
ImageList_Destroy Zerstört eine Bildliste.
ImageList_DragEnter Zeigt das Ziehbild an der angegebenen Position innerhalb des Fensters 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 Blendet das gezogene Bild ein oder aus.
ImageList_Draw Zeichnet ein Bildlistenelement im angegebenen Gerätekontext.
ImageList_DrawEx Zeichnet ein Bildlistenelement im angegebenen Gerätekontext. Die Funktion verwendet den angegebenen Zeichenstil und blendet das Bild mit der angegebenen Farbe zusammen.
ImageList_DrawIndirect Zeichnet ein Bildlistenbild basierend auf einer IMAGELISTDRAWPARAMS Struktur.
ImageList_Duplicate Erstellt ein Duplikat einer vorhandenen Bildliste.
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 Ziehbild 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 einer Maske in einer Bildliste.
ImageList_GetIconSize Ruft die Abmessungen von Bildern in einer Bildliste ab. Alle Bilder in einer Bildliste weisen die gleichen Abmessungen auf.
ImageList_GetImageCount Ruft die Anzahl der Bilder in einer Bildliste ab.
ImageList_GetImageInfo Ruft Informationen zu einem Bild ab.
ImageList_LoadImage Erstellt eine Bildliste aus der angegebenen Bitmap.
ImageList_Merge Erstellt ein neues Bild, indem zwei vorhandene Bilder kombiniert werden. Die Funktion erstellt auch eine neue Bildliste, in der das Bild gespeichert werden soll.
ImageList_Read Liest eine Bildliste aus einem Datenstrom.
ImageList_ReadEx Liest eine Bildliste aus einem Datenstrom 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 Bild.
ImageList_ReplaceIcon Ersetzt ein Bild durch ein Symbol oder 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 Mauszeigerbild) mit dem aktuellen Ziehbild kombiniert wird.
ImageList_SetIconSize Legt die Abmessungen 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 aufweisen. Die Funktion weist dem angegebenen Bild einen Überlagerungsformatindex zu.
ImageList_Write Schreibt eine Bildliste in einen Datenstrom.
ImageList_WriteEx Schreibt eine Bildliste in einen Datenstrom.

Macros

Thema Inhalt
ImageList_AddIcon Fügt einer Bildliste ein Symbol oder Cursor hinzu. ImageList_AddIcon ruft die ImageList_ReplaceIcon-Funktion auf.
ImageList_ExtractIcon Ruft die ImageList_GetIcon-Funktion auf, um ein Symbol oder 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 Inhalt
IImageList- Macht Methoden verfügbar, die Bildlisten bearbeiten und mit ihnen interagieren.
Wenn Sie IImageList-verwenden möchten, 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.

Methodik

Thema Inhalt
hinzufügen Fügt einer Bildliste ein Bild oder Bilder hinzu.
AddMasked Fügt einer Bildliste ein Bild oder Bilder hinzu, wobei eine Maske aus der angegebenen Bitmap generiert wird.
BeginDrag- Beginnt mit dem Ziehen eines Bilds.
Klonen Klont eine vorhandene Bildliste.
Kopieren Kopiert Bilder aus einer bestimmten Bildliste.
DragEnter- Sperrt updates to the specified window during a drag operation and displays the drag image at the specified position within the window.
DragLeave- Entsperrt das angegebene Fenster und blendet das Ziehbild aus, wodurch 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 Reaktion auf eine WM_MOUSEMOVE Nachricht aufgerufen.
DragShowNolock- Blendet das gezogene Bild ein oder 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 Ziehbild 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 einer Maske in einer Bildliste.
GetIconSize- Ruft die Abmessungen von Bildern in einer Bildliste ab. Alle Bilder in einer Bildliste weisen die gleichen Abmessungen auf.
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 Bilds ab.
GetOverlayImage- Ruft ein angegebenes Bild aus der Liste der Bilder ab, die als Überlagerungsmasken verwendet werden.
zusammenführen Erstellt ein neues Bild, indem zwei vorhandene Bilder kombiniert werden. Mit dieser Methode wird auch eine neue Bildliste erstellt, in der das Bild gespeichert werden soll.
entfernen Entfernt ein Bild aus einer Bildliste.
Ersetzen Ersetzt ein Bild in einer Bildliste durch ein neues Bild.
ReplaceIcon Ersetzt ein Bild durch ein Symbol oder 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 eine Maske zeichnet das gesamte Bild, und die Hintergrundfarbe ist nicht sichtbar.
SetDragCursorImage- Erstellt ein neues Ziehbild, indem das angegebene Bild, das normalerweise ein Mauscursorbild ist, mit dem aktuellen Ziehbild kombiniert wird.
SetIconSize- Legt die Abmessungen 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 Überlagerungsformate in allgemeinen Steuerelementen Version 4.70 und früheren Versionen und bis zu 15 in Version 4.71 oder höher aufweisen. Die Methode weist dem angegebenen Bild einen Überlagerungsformatindex zu.

Strukturen

Thema Inhalt
IMAGEINFO- Enthält Informationen zu einem Bild in einer Bildliste. Diese Struktur wird mit der funktion IImageList::GetImageInfo verwendet.
IMAGELISTDRAWPARAMS Enthält Informationen zu einem Bildlisten-Draw-Vorgang und wird mit der funktion IImageList::D raw verwendet.