ICONINFOEXA-Struktur (winuser.h)

Artikel
11/20/2024

Enthält Informationen zu einem Symbol oder einem Cursor. Erweitert ICONINFO-. Wird von GetIconInfoExverwendet.

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;

Angehörige

cbSize

Typ: DWORD-

Die Größe dieser Struktur in Byte.

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

Typ: 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

Typ: DWORD-

Die Y-Koordinate des Cursor-Hotspots. 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 zur monochromen Symbolmaske Bitmap-.

hbmColor

Typ: HBITMAP-

Ein Handle zur Symbolfarbe Bitmap-.

wResID

Typ: WORD-

Ressourcenbezeichner der Ressource in szModName Modul. Wenn das Symbol oder der Cursor anhand des Namens geladen wurde, ist wResID- null und szResName- den Ressourcennamen enthält.

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

szModName[MAX_PATH]

Typ: TCHAR[MAX_PATH]

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

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

szResName[MAX_PATH]

Typ: TCHAR[MAX_PATH]

Ressourcenname der Ressource in szModName Modul.

Bemerkungen

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

Bei Farbsymbolen sind die hbmMask und hbmColor Bitmaps die gleiche Größe, von denen jede die Größe des Symbols ist.

Sie können eine GetObject--Funktion verwenden, um Inhalte 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 ICONINFO Struktur mit zusätzlichen szModName/szResName/wResID Membern, die zum Abfragen eines Symbol- oder Cursorressourcenbits verwendet werden können. Diese Bits werden in der Regel durch Aufrufe der funktionen FindResource, LoadResource, LockResource und LookupIconIdFromDirectoryEx geladen.

Anmerkung

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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Header-	winuser.h (enthalten Windows.h)