Struttura ICONINFOEXA (winuser.h)

Articolo
06/21/2023

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

Sintassi

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;

Members

cbSize

Tipo: DWORD

Dimensione, in byte, della 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, l'area a caldo 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, l'area a caldo si trova sempre al centro dell'icona e questo membro viene ignorato.

hbmMask

Tipo: HBITMAP

Handle per la bitmap della maschera monocromatica dell'icona.

hbmColor

Tipo: HBITMAP

Handle per la bitmap del colore dell'icona.

wResID

Tipo: WORD

Identificatore di risorsa della risorsa nel 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 la 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 la funzione GetModuleHandle per convertirla nell'handle del modulo compatibile con le funzioni di gestione delle risorse.

szResName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Nome della risorsa nel modulo szModName .

Commenti

Per le icone monocromatica, 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 bitmap hbmMask e 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 nelle bitmap in questa struttura.

ICONINFOEX è una versione estesa della struttura ICONINFO con ulteriori membri szModName szResName//wResID che possono essere usati per eseguire query su un'icona o su bit di risorsa 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

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)