ImageList_ExtractIcon Makro (commctrl.h)

Artikel
10/24/2024

Ruft die ImageList_GetIcon-Funktion auf, um ein Symbol oder Cursor basierend auf einem Bild und einer Maske in einer Bildliste zu erstellen.

Syntax

HICON ImageList_ExtractIcon(
   HINSTANCE  hi,
   HIMAGELIST himl,
   int        i
);

Parameter

hi

Typ: HINSTANCE-

Dieser Parameter wird nicht verwendet und sollte immer Null sein.

himl

Typ: HIMAGELIST

Ein Handle für die Bildliste.

i

Typ: int

Der Index des Bilds.

Rückgabewert

Typ: HICON-

Gibt das Handle des Symbols oder Cursors zurück, wenn dies erfolgreich war, oder NULL- andernfalls.

Bemerkungen

Es liegt in der Verantwortung der aufrufenden Anwendung, das von dieser Funktion zurückgegebene Symbol mithilfe der DestroyIcon-Funktion zu zerstören.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h

Freigeben über