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