ICONINFOEXA-Struktur (winuser.h)

Artikel
03/06/2024

Enthält Informationen zu einem Symbol oder einem Cursor. Erweitert ICONINFO. Wird von GetIconInfoEx verwendet.

Syntax

typedef struct _ICONINFOEXA {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  CHAR    szModName[MAX_PATH];
  CHAR    szResName[MAX_PATH];
} ICONINFOEXA, *PICONINFOEXA;

Member

cbSize

Art: DWORD

Die Größe (in Bytes) dieser Struktur.

fIcon

Typ: BOOL

Gibt an, ob diese Struktur ein Symbol oder einen Cursor definiert. Ein Wert von TRUE gibt ein Symbol an. FALSE gibt einen Cursor an.

xHotspot

Art: DWORD

Die x-Koordinate des Hotspots eines Cursors. Wenn diese Struktur ein Symbol definiert, befindet sich der Hotspot immer in der Mitte des Symbols, und dieses Element wird ignoriert.

yHotspot

Art: DWORD

Die y-Koordinate des Hotspots des Cursors. Wenn diese Struktur ein Symbol definiert, befindet sich der Hotspot immer in der Mitte des Symbols, und dieses Element wird ignoriert.

hbmMask

Typ: HBITMAP

Ein Handle für die Bitmap der monochromen Symbolmaske.

hbmColor

Typ: HBITMAP

Ein Handle für die Symbolfarbbitbit.

wResID

Typ: WORD

Ressourcenbezeichner der Ressource im Modul szModName . Wenn das Symbol oder der Cursor nach Name geladen wurde, ist wResID 0, und szResName enthält den Ressourcennamen.

Sie können das MAKEINTRESOURCE(wResID)-Makro verwenden, um den Ressourcenbezeichner in einen Ressourcennamenstyp zu konvertieren, der mit den Ressourcenverwaltungsfunktionen kompatibel ist.

szModName[MAX_PATH]

Typ: TCHAR[MAX_PATH]

Name des Moduls, aus dem ein Symbol oder ein Cursor geladen wurde.

Sie können die GetModuleHandle-Funktion verwenden, um sie in das Modulhandle zu konvertieren, das mit den Ressourcenverwaltungsfunktionen kompatibel ist.

szResName[MAX_PATH]

Typ: TCHAR[MAX_PATH]

Ressourcenname der Ressource im SzModName-Modul .

Hinweise

Bei monochromen Symbolen ist hbmMask doppelt so hoch wie das Symbol (mit der AND-Maske oben und der XOR-Maske unten), und hbmColor ist NULL. Auch in diesem Fall sollte die Höhe ein gerades Vielfaches von zwei sein.

Bei Farbsymbolen haben die Bitmaps hbmMask und hbmColor dieselbe Größe, wobei jede der Größe des Symbols entspricht.

Sie können eine GetObject-Funktion verwenden, um Inhalte von hbmMask und hbmColor in der BITMAP-Struktur abzurufen. Die Bitmapbits können mit dem Aufruf von GetDIBits für die Bitmaps in dieser Struktur abgerufen werden.

ICONINFOEX ist eine erweiterte Version der ICONINFO-Struktur mit zusätzlichen szModName/szResName/wResID-Membern , die zum Abfragen von Symbol- oder Cursorressourcenbits verwendet werden können. Diese Bits werden in der Regel durch Aufrufe der Funktionen FindResource, LoadResource, LockResource und LookupIconIdFromDirectoryEx geladen.

Hinweis

Der winuser.h-Header definiert ICONINFOEX als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	winuser.h (einschließlich Windows.h)