Estructura ICONINFOEXA (winuser.h)

Artículo
03/04/2024

Contiene información sobre un icono o un cursor. Extiende ICONINFO. Usado por GetIconInfoEx.

Sintaxis

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;

Miembros

cbSize

Tipo: DWORD

Tamaño, en bytes, de esta estructura.

fIcon

Tipo: BOOL

Especifica si esta estructura define un icono o un cursor. Un valor de TRUE especifica un icono; FALSE especifica un cursor.

xHotspot

Tipo: DWORD

Coordenada x de la zona activa de un cursor. Si esta estructura define un icono, la zona activa siempre se encuentra en el centro del icono y se omite este miembro.

yHotspot

Tipo: DWORD

Coordenada y de la zona activa del cursor. Si esta estructura define un icono, la zona activa siempre se encuentra en el centro del icono y se omite este miembro.

hbmMask

Tipo: HBITMAP

Identificador del mapa de bits de máscara monocromática del icono.

hbmColor

Tipo: HBITMAP

Identificador del mapa de bits de color del icono.

wResID

Tipo: WORD

Identificador de recurso del recurso en el módulo szModName . Si el icono o el cursor se cargó por nombre, wResID es cero y szResName contiene el nombre del recurso.

Puede usar la macro MAKEINTRESOURCE(wResID) para convertir el identificador de recurso en un tipo de nombre de recurso compatible con las funciones de administración de recursos.

szModName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Nombre del módulo desde el que se cargó un icono o un cursor.

Puede usar la función GetModuleHandle para convertirlo en el identificador del módulo compatible con las funciones de administración de recursos.

szResName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Nombre del recurso en el módulo szModName .

Comentarios

Para los iconos monocromáticos, hbmMask es el doble de altura del icono (con la máscara AND en la parte superior y la máscara XOR en la parte inferior), y hbmColor es NULL. Además, en este caso, el alto debe ser incluso múltiplo de dos.

Para los iconos de color, los mapas de bits hbmMask y hbmColor tienen el mismo tamaño, cada uno de los cuales es el tamaño del icono.

Puede usar una función GetObject para obtener el contenido de hbmMask y hbmColor en la estructura BITMAP . Los bits de mapa de bits se pueden obtener con la llamada a GetDIBits en los mapas de bits de esta estructura.

ICONINFOEX es una versión extendida de la estructura ICONINFO con miembros adicionales szModName/szResName/wResID que se pueden usar para consultar un icono o bits de recursos de cursor. Normalmente, estos bits se cargan mediante llamadas a las funciones FindResource, LoadResource, LockResource y LookupIconIdFromDirectoryEx .

Nota

El encabezado winuser.h define ICONINFOEX como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	winuser.h (incluir Windows.h)