Struttura ICONINFOEXW (winuser.h)

Articolo
11/20/2024

Contiene informazioni su un'icona o un cursore. Estende ICONINFO. Usato da GetIconInfoEx.

Sintassi

typedef struct _ICONINFOEXW {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  WCHAR   szModName[MAX_PATH];
  WCHAR   szResName[MAX_PATH];
} ICONINFOEXW, *PICONINFOEXW;

Membri

cbSize

Tipo: DWORD

Dimensione, in byte, di questa struttura.

fIcon

Tipo: bool

Specifica se questa struttura definisce un'icona o un cursore. Il valore TRUE specifica un'icona; false specifica un cursore.

xHotspot

Tipo: DWORD

Coordinata x del punto attivo di un cursore. Se questa struttura definisce un'icona, il punto critico si trova sempre al centro dell'icona e questo membro viene ignorato.

yHotspot

Tipo: DWORD

Coordinata y del punto attivo del cursore. Se questa struttura definisce un'icona, il punto critico si trova sempre al centro dell'icona e questo membro viene ignorato.

hbmMask

Tipo: HBITMAP

Handle per la maschera monocromatica dell'icona bitmap.

hbmColor

Tipo: HBITMAP

Handle per il colore dell'icona bitmap.

wResID

Tipo: WORD

Identificatore di risorsa della risorsa in modulo szModName. Se l'icona o il cursore è stato caricato in base al nome, wResID è zero e szResName contiene il nome della risorsa.

È possibile usare macro MAKEINTRESOURCE(wResID) per convertire l'identificatore di risorsa in un tipo di nome di risorsa compatibile con le funzioni di gestione delle risorse .

szModName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Nome del modulo da cui è stata caricata un'icona o un cursore.

È possibile usare funzione di GetModuleHandle per convertirla nell'handle del modulo compatibile con le funzioni di gestione delle risorse .

szResName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Nome risorsa della risorsa in modulo szModName.

Osservazioni

Per le icone monocromatica, il hbmMask è due volte l'altezza dell'icona (con la maschera AND in alto e la maschera XOR nella parte inferiore) e hbmColor è NULL. Inoltre, in questo caso l'altezza deve essere un multiplo pari a due.

Per le icone dei colori, le hbmMask e bitmap hbmColor hanno le stesse dimensioni, ognuna delle quali corrisponde alla dimensione dell'icona.

È possibile usare una funzione GetObject per ottenere il contenuto di hbmMask e hbmColor nella struttura BITMAP . I bit bitmap possono essere ottenuti con la chiamata a GetDIBits sulle bitmap in questa struttura.

ICONINFOEX è una versione estesa della struttura ICONINFO con ulteriori szModName/szResName/wResID membri che possono essere usati per eseguire query su un bit di risorsa icona o cursore. Questi bit vengono in genere caricati dalle chiamate alle funzioni FindResource, LoadResource, LockResource e LookupIconIdFromDirectoryEx.

Nota

L'intestazione winuser.h definisce ICONINFOEX come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
intestazione	winuser.h (include Windows.h)