Freigeben über


CreateIconIndirect-Funktion (winuser.h)

Erstellt ein Symbol oder einen Cursor aus einer ICONINFO-Struktur .

Syntax

HICON CreateIconIndirect(
  [in] PICONINFO piconinfo
);

Parameter

[in] piconinfo

Typ: PICONINFO

Ein Zeiger auf eine ICONINFO-Struktur , die die Funktion zum Erstellen des Symbols oder Cursors verwendet.

Rückgabewert

Typ: HICON

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das erstellte Symbol oder den Cursor.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Das System kopiert die Bitmaps in der ICONINFO-Struktur , bevor das Symbol oder der Cursor erstellt wird. Da das System die Bitmaps vorübergehend in einem Gerätekontext auswählt, sollten die Elemente hbmMask und hbmColor der ICONINFO-Struktur nicht bereits in einem Gerätekontext ausgewählt werden. Die Anwendung muss die ursprünglichen Bitmaps weiterhin verwalten und löschen, wenn sie nicht mehr benötigt werden.

Wenn Sie mit der Verwendung des Symbols fertig sind, zerstören Sie es mit der DestroyIcon-Funktion .

Beispiele

Ein Beispiel finden Sie unter Erstellen eines Cursors.

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 (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-gui-l1-3-0 (eingeführt in Windows 10, Version 10.0.10240)

Siehe auch

Konzept

DestroyIcon

ICONINFO

Symbole