STRUCTURE ICONINFOEXA (winuser.h)

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. Une valeur de 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 du masque monochrome icône bitmap.

hbmColor

Type : HBITMAP

Handle de la couleur d’icône bitmap.

wResID

Type : WORD

Identificateur de ressource de la ressource dans 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 macro MAKEINTRESOURCE(wResID) pour convertir l’identificateur de ressource en 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 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 module szModName.

Remarques

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

Pour les icônes de couleur, les images bitmap hbmMask et hbmColor sont de 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 avec un appel à GetDIBits sur les bitmaps de cette structure.

ICONINFOEX est une version étendue de structure ICONINFO avec des supplémentaires szModName/szResName/wResID membres qui peuvent être utilisés pour interroger des bits de ressource d’icône ou de curseur. Ces bits sont généralement chargés par des appels auxFindResource , LoadResource, LockResource et Fonctions LookupIconIdFromDirectoryEx.

Note

L’en-tête winuser.h définit ICONINFOEX comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
d’en-tête	winuser.h (include Windows.h)

Voir aussi

conceptuelle

CreateIconIndirect

GetIconInfo

icônes

bitmaps

GetObject

BITMAP

GetDIBits

de référence