GetIconInfoExA-Funktion (winuser.h)

Artikel
20.11.2024

Ruft Informationen zum angegebenen Symbol oder Cursor ab. GetIconInfoEx erweitert GetIconInfo mithilfe der neueren ICONINFOEX Struktur.

Syntax

C++

BOOL GetIconInfoExA(
  [in]      HICON        hicon,
  [in, out] PICONINFOEXA piconinfo
);

Parameter

[in] hicon

Typ: HICON-

Ein Ziehpunkt für das Symbol oder den Cursor.

Wenn Sie Informationen zu einem Standardsymbol oder Cursor abrufen möchten, geben Sie den Bezeichner an, der mit dem präfix IDI_ oder dem Bezeichner beginnt, der mit dem präfix IDC_ in diesem Parameter beginnt.

[in, out] piconinfo

Typ: PICNINFOEX

Wenn diese Methode zurückgegeben wird, enthält sie einen Zeiger auf eine ICONINFOEX- Struktur. Die Funktion füllt die Elemente der Struktur aus.

Rückgabewert

Typ: BOOL-

TRUE- bedeutet Erfolg, FALSE- einen Fehler angibt.

Bemerkungen

GetIconInfoEx erstellt Bitmaps für die hbmMask und hbmColor oder Member von ICONINFOEX. Die aufrufende Anwendung muss diese Bitmaps verwalten und mit DeleteObject Aufruf löschen, wenn sie nicht mehr erforderlich sind.

DPI-Virtualisierung

Diese API nimmt nicht an der DPI-Virtualisierung teil. Die zurückgegebene Ausgabe wird vom DPI-Wert des aufrufenden Threads nicht beeinflusst.

Hinweis

Der winuser.h-Header definiert GetIconInfoEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll