STRUCTURE ICONINFOEXA (winuser.h)

Article
03/13/2024

Contient des informations sur une icône ou un curseur. Étend ICONINFO. Utilisé par GetIconInfoEx.

Syntaxe

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;

Membres

cbSize

Type : DWORD

Taille, en octets, de cette structure.

fIcon

Type : BOOL

Spécifie si cette structure définit une icône ou un curseur. La valeur TRUE spécifie une icône ; FALSE spécifie un curseur.

xHotspot

Type : DWORD

Coordonnée x du point chaud d’un curseur. Si cette structure définit une icône, le point chaud se trouve toujours au centre de l’icône et ce membre est ignoré.

yHotspot

Type : DWORD

Coordonnée y du point chaud du curseur. Si cette structure définit une icône, le point chaud se trouve toujours au centre de l’icône et ce membre est ignoré.

hbmMask

Type : HBITMAP

Poignée de l’icône bitmap de masque monochrome.

hbmColor

Type : HBITMAP

Handle de l’image bitmap de la couleur de l’icône.

wResID

Type : WORD

Identificateur de ressource de la ressource dans le module szModName . Si l’icône ou le curseur a été chargé par nom, wResID est égal à zéro et szResName contient le nom de la ressource.

Vous pouvez utiliser la macro MAKEINTRESOURCE(wResID) pour convertir l’identificateur de ressource en un type de nom de ressource compatible avec les fonctions de gestion des ressources.

szModName[MAX_PATH]

Type : TCHAR[MAX_PATH]

Nom du module à partir duquel une icône ou un curseur a été chargé.

Vous pouvez utiliser la fonction GetModuleHandle pour la convertir en handle de module compatible avec les fonctions de gestion des ressources.

szResName[MAX_PATH]

Type : TCHAR[MAX_PATH]

Nom de la ressource dans le module szModName .

Remarques

Pour les icônes monochromes, hbmMask a deux fois la hauteur de l’icône (avec le masque AND en haut et le masque XOR en bas), et hbmColor a la valeur NULL. En outre, dans ce cas, la hauteur doit être un multiple pair de deux.

Pour les icônes de couleur, les bitmaps hbmMask et hbmColor ont la même taille, chacune étant la taille de l’icône.

Vous pouvez utiliser une fonction GetObject pour obtenir le contenu de hbmMask et hbmColor dans la structure BITMAP . Les bits bitmap peuvent être obtenus en appelant GetDIBits sur les bitmaps de cette structure.

ICONINFOEX est une version étendue de la structure ICONINFO avec des membreswResIDsupplémentaires szModName/szResName/ qui peuvent être utilisés pour interroger une icône ou des bits de ressource de curseur. Ces bits sont généralement chargés par des appels aux fonctions FindResource, LoadResource, LockResource et LookupIconIdFromDirectoryEx .

Notes

L’en-tête winuser.h définit ICONINFOEX comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	winuser.h (inclure Windows.h)