CreateIconFromResource-Funktion (winuser.h)
Erstellt ein Symbol oder Cursor aus Ressourcenbits, die das Symbol beschreiben.
Um eine gewünschte Höhe oder Breite anzugeben, verwenden Sie die Funktion CreateIconFromResourceEx .
Syntax
HICON CreateIconFromResource(
[in] PBYTE presbits,
[in] DWORD dwResSize,
[in] BOOL fIcon,
[in] DWORD dwVer
);
Parameter
[in] presbits
Typ: PBYTE
Der DWORD-ausgerichtete Pufferzeiger, der das Symbol oder die Cursorressourcenbits enthält. Diese Bits werden in der Regel durch Aufrufe der Funktionen LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx und LoadResource geladen.
Weitere Informationen zum Symbol - und Cursorressourcenformat finden Sie unter Cursor- und Symbolressourcenressourcen.
[in] dwResSize
Art: DWORD
Die Größe der Bitmenge in Bytes, auf die der presbits-Parameter verweist.
[in] fIcon
Typ: BOOL
Gibt an, ob ein Symbol oder ein Cursor erstellt werden soll. Wenn dieser Parameter TRUE ist, wird ein Symbol erstellt. Wenn es FALSE ist, soll ein Cursor erstellt werden.
Die LOCALHEADER-Struktur definiert den Cursor-Hotspot und ist die ersten Daten, die aus den Cursorressourcenbits gelesen werden.
[in] dwVer
Art: DWORD
Die Versionsnummer des Symbols oder Cursorformats für die Ressourcenbits, auf die vom presbits-Parameter verwiesen wird. Der Wert muss größer oder gleich 0x00020000 und kleiner als oder gleich 0x00030000 sein. Dieser Parameter ist im Allgemeinen auf 0x00030000 festgelegt.
Rückgabewert
Typ: HICON
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das 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
Mit den Funktionen CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LookupIconIdFromDirectory und LookupIconIdFromDirectoryEx können Shellanwendungen und Symbolbrowser Ressourcen im gesamten System untersuchen und verwenden.
Die CreateIconFromResource-Funktion ruft CreateIconFromResourceEx auf, die als Flags übergeben LR_DEFAULTSIZE|LR_SHARED wird.
Sie sollten DestroyIcon für Symbole oder DestroyCursor für Cursor aufrufen, die mit CreateIconFromResource erstellt wurden.
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 |
Siehe auch
Konzept
Referenz