CreateIconFromResourceEx-Funktion (winuser.h)

Artikel
11/20/2024

Erstellt ein Symbol oder Cursor aus Ressourcenbits, die das Symbol beschreiben.

Syntax

HICON CreateIconFromResourceEx(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

Parameter

[in] presbits

Typ: PBYTE-

Der DWORD-ausgerichtete Pufferzeiger, der das Symbol (RT_ICON) oder Cursor (RT_CURSOR) Ressourcenbits enthält. Diese Bits werden in der Regel durch Aufrufe der funktionen LookupIconIdFromDirectoryEx und LoadResource- geladen.

Weitere Informationen zum Symbol- und Cursorressourcenformat finden Sie unter für Cursor und Cursor.

[in] dwResSize

Typ: DWORD-

Die Größe der Bitgruppe in Byte, auf die der pbIconBits-Parameter verweist.

[in] fIcon

Typ: BOOL-

Gibt an, ob ein Symbol oder ein Cursor erstellt werden soll. Wenn dieser Parameter TRUEist, wird ein Symbol erstellt. Wenn es FALSE-ist, wird ein Cursor erstellt.

Die LOCALHEADER- Struktur definiert den Cursor-Hotspot und ist die erste Daten, die aus den Cursorressourcenbits gelesen werden.

[in] dwVer

Typ: DWORD-

Die Versionsnummer des Symbol- oder Cursorformats für die Ressourcenbits, auf die durch die presbits Parameter verwiesen wird. Der Wert muss größer oder gleich 0x00020000 und kleiner oder gleich 0x00030000 sein. Dieser Parameter wird in der Regel auf 0x00030000 festgelegt.

[in] cxDesired

Typ: int

Die Breite des Symbols oder Cursors in Pixel. Wenn dieser Parameter null ist und der parameter FlagsLR_DEFAULTSIZEist, verwendet die Funktion den SM_CXICON- oder SM_CXCURSOR Systemmetrikwert, um die Breite festzulegen. Wenn dieser Parameter null ist und LR_DEFAULTSIZE nicht verwendet wird, verwendet die Funktion die tatsächliche Ressourcenbreite.

[in] cyDesired

Typ: int

Die Höhe des Symbols oder Cursors in Pixel. Wenn dieser Parameter null ist und der parameter FlagsLR_DEFAULTSIZEist, verwendet die Funktion den SM_CYICON- oder SM_CYCURSOR Systemmetrikwert, um die Höhe festzulegen. Wenn dieser Parameter null ist und LR_DEFAULTSIZE nicht verwendet wird, verwendet die Funktion die tatsächliche Ressourcenhöhe.

[in] Flags

Typ: UINT-

Eine Kombination der folgenden Werte.

Wert	Bedeutung
LR_DEFAULTCOLOR 0x00000000	Verwendet das Standardfarbformat.
LR_DEFAULTSIZE 0x00000040	Verwendet die durch die Systemmetrikwerte angegebene Breite oder Höhe für Cursor oder Symbole, wenn die cxDesired oder cyDesired Werte auf Null festgelegt sind. Wenn dieses Flag nicht angegeben ist und cxDesired und cyDesired auf Null festgelegt sind, verwendet die Funktion die tatsächliche Ressourcengröße.
LR_MONOCHROME 0x00000001	Erstellt ein monochromes Symbol oder Cursor.
LR_SHARED 0x00008000	Teilt das Symbol oder den Cursorziehpunkt, wenn das Symbol oder der Cursor mehrmals erstellt wird. Wenn LR_SHARED nicht festgelegt ist, erstellt ein zweiter Aufruf von CreateIconFromResourceEx- für dieselbe Ressource das Symbol oder den Cursor erneut und gibt ein anderes Handle zurück. Wenn Sie dieses Kennzeichen verwenden, zerstört das System die Ressource, wenn sie nicht mehr benötigt wird. Verwenden Sie LR_SHARED nicht für Symbole oder Cursor mit nicht standardmäßigen Größen, die sich nach dem Laden ändern oder aus einer Datei geladen werden.

Rückgabewert

Typ: HICON-

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Die CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfound LookupIconIdFromDirectoryEx Funktionen ermöglichen Shellanwendungen und Symbolbrowsern das Untersuchen und Verwenden von Ressourcen im gesamten System.

Sie sollten DestroyIcon für Symbole oder DestroyCursor- für Cursor aufrufen, die mit CreateIconFromResourceExerstellt wurden.

Beispiele

Ein Beispiel finden Sie unter Sharing Icon Resources.

Anforderungen

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