Estructura ICONINFOEXA (winuser.h)

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 de

Tamaño, en bytes, de esta estructura.

fIcon

Tipo: BOOL de

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

xHotspot

Tipo: DWORD de

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

yHotspot

Tipo: DWORD de

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

hbmMask

Tipo: HBITMAP

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

hbmColor

Tipo: HBITMAP

Identificador del color del icono mapa de bits.

wResID

Tipo: word

Identificador de recurso del recurso en 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 macro MAKEINTRESOURCE(wResID) para convertir el identificador de recursos en un tipo de nombre de recurso compatible con las funciones de administración de recursos de .

szModName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

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

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

szResName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Nombre de recurso del recurso en módulo szModName.

Observaciones

Para los iconos monocromáticos, el 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 un par de dos.

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

Puede usar una función de GetObject para obtener el contenido de hbmMask y hbmColor en la estructura BITMAP de . 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 estructura ICONINFO con miembros adicionales de szModName/szResName/wResID miembros que se pueden usar para consultar un icono o bits de recursos de cursor. Normalmente, estas bits se cargan mediante llamadas al FindResource, LoadResource, lockResource y funciones 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
encabezado de	winuser.h (incluya Windows.h)

Consulte también

conceptual de

CreateIconIndirect

GetIconInfo

iconos

mapas de bits de

GetObject

BITMAP

GetDIBits

de referencia de