ImageList_Create-Funktion (commctrl.h)

Erstellt eine neue Imageliste.

Syntax

HIMAGELIST ImageList_Create(
  int  cx,
  int  cy,
  UINT flags,
  int  cInitial,
  int  cGrow
);

Parameter

cx

Typ: int

Die Breite jedes Bilds in Pixel.

cy

Typ: int

Die Höhe jedes Bilds in Pixel.

flags

Typ: UINT

Eine Reihe von Bitflags, die den Typ der zu erstellenden Bildliste angeben. Bei diesem Parameter kann es sich um eine Kombination der Flags für die Erstellung von Imagelisten handeln.

cInitial

Typ: int

Die Anzahl der Bilder, die die Bildliste anfänglich enthält.

cGrow

Typ: int

Die Anzahl der Bilder, um die die Bildliste wachsen kann, wenn das System Platz für neue Images schaffen muss. Dieser Parameter stellt die Anzahl neuer Bilder dar, die die Liste der geänderten Bildgrößen enthalten kann.

Rückgabewert

Typ: HIMAGELIST

Gibt das Handle bei erfolgreicher Ausführung an die Imageliste zurück, andernfalls NULL .

Hinweise

Wenn Sie mit der Verwendung der Bildliste fertig sind, zerstören Sie sie, indem Sie die funktion ImageList_Destroy aufrufen.

Beachten Sie Comctl32.dll Version 6 nicht verteilbar ist, aber in Windows oder höher enthalten ist. Um Comctl32.dll Version 6 zu verwenden, geben Sie sie in einem Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

 

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)