Freigeben über


GetIconInfo-Funktion (winuser.h)

Ruft Informationen zum angegebenen Symbol oder Cursor ab.

Syntax

BOOL GetIconInfo(
  [in]  HICON     hIcon,
  [out] PICONINFO piconinfo
);

Parameter

[in] hIcon

Typ: HICON

Ein Handle für das Symbol oder den Cursor.

Um Informationen zu einem Standardsymbol oder -cursor abzurufen, geben Sie den Bezeichner ab dem präfix IDI_ oder den Bezeichner ab dem präfix IDC_ in diesem Parameter an.

[out] piconinfo

Typ: PICONINFO

Ein Zeiger auf eine ICONINFO-Struktur . Die Funktion füllt die Elemente der Struktur aus.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert nonzero, und die Funktion füllt die Member der angegebenen ICONINFO-Struktur aus.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

GetIconInfo erstellt Bitmaps für hbmMask und hbmColor oder Elemente von ICONINFO. Die aufrufende Anwendung muss diese Bitmaps verwalten und mit dem DeleteObject-Aufruf löschen, wenn sie nicht mehr erforderlich sind.

DPI-Virtualisierung

Diese API ist nicht an der DPI-Virtualisierung beteiligt. Die zurückgegebene Ausgabe wird nicht von der DPI des aufrufenden Threads beeinflusst.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-gui-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Konzept

Bitmaps

Symbole

DeleteObject

GetObject

BITMAP

CreateIcon

CreateIconFromResource

CreateIconIndirect

DestroyIcon

Drawicon

DrawIconEx

LoadIcon

LookupIconIdFromDirectory

ICONINFO