IImageList::GetIcon-Methode (commoncontrols.h)

Artikel
02/26/2024

Erstellt ein Symbol aus einem Bild und eine Maske in einer Bildliste.

Syntax

HRESULT GetIcon(
  [in]  int   i,
  [in]  UINT  flags,
  [out] HICON *picon
);

Parameter

[in] i

Typ: int

Ein Wert vom Typ int , der den Index des Bilds enthält.

[in] flags

Typ: UINT

Eine Kombination von Flags, die den Zeichnungsstil angeben. Eine Liste der Werte finden Sie unter IImageList::D raw.

[out] picon

Typ: HICON*

Ein Zeiger auf ein int , das das Handle auf das Symbol enthält, falls erfolgreich, oder NULL , falls andernfalls.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die aufrufende Anwendung muss das von dieser Methode zurückgegebene Symbol mithilfe von DestroyIcon zerstören.

Um IImageList::GetIcon zu verwenden, geben Sie Comctl32.dll Version 6 im Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commoncontrols.h
DLL	Comctl32.dll (Version 6.0 oder höher)

Share via