Función CreateIconFromResourceEx (winuser.h)

Crea un icono o cursor a partir de bits de recursos que describen el icono.

Sintaxis

HICON CreateIconFromResourceEx(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

Parámetros

[in] presbits

Tipo: pbyte de

Puntero de búfer alineado con DWORD que contiene los bits de recurso de icono (RT_ICON) o cursor (RT_CURSOR). Normalmente, estas bits se cargan mediante llamadas a la LookupIconIdFromDirectoryEx y funciones de LoadResource.

Consulte cursor y recursos de icono para obtener más información sobre el formato de recursos de cursor y icono.

[in] dwResSize

Tipo: DWORD de

Tamaño, en bytes, del conjunto de bits al que apunta el parámetro pbIconBits.

[in] fIcon

Tipo: BOOL de

Indica si se va a crear un icono o un cursor. Si este parámetro es TRUE, se creará un icono. Si es FALSE, se creará un cursor.

La estructura LOCALHEADER define la zona activa del cursor y es la primera lectura de los datos de los bits de recursos del cursor.

[in] dwVer

Tipo: DWORD de

Número de versión del formato de cursor o icono para los bits de recurso a los que apunta el parámetro presbits. El valor debe ser mayor o igual que 0x00020000 y menor o igual que 0x00030000. Este parámetro se establece generalmente en 0x00030000.

[in] cxDesired

Tipo: int

Ancho, en píxeles, del icono o cursor. Si este parámetro es cero y el parámetro Flags es LR_DEFAULTSIZE, la función usa el valor de métrica del sistema SM_CXICON o SM_CXCURSOR para establecer el ancho. Si este parámetro es cero y no se usa LR_DEFAULTSIZE, la función usa el ancho real del recurso.

[in] cyDesired

Tipo: int

Alto, en píxeles, del icono o cursor. Si este parámetro es cero y el parámetro Flags es LR_DEFAULTSIZE, la función usa el SM_CYICON o SM_CYCURSOR valor de métrica del sistema para establecer el alto. Si este parámetro es cero y no se usa LR_DEFAULTSIZE, la función usa el alto real del recurso.

[in] Flags

Tipo: UINT

Combinación de los valores siguientes.

Valor	Significado
LR_DEFAULTCOLOR 0x00000000	Usa el formato de color predeterminado.
LR_DEFAULTSIZE 0x00000040	Usa el ancho o alto especificado por los valores de métrica del sistema para cursores o iconos, si los valores de cxDesired o cyDesired se establecen en cero. Si no se especifica esta marca y cxDesired y cyDesired se establecen en cero, la función usa el tamaño real del recurso.
LR_MONOCHROME 0x00000001	Crea un icono o cursor monocromáticos.
LR_SHARED 0x00008000	Comparte el icono o el identificador del cursor si el icono o el cursor se crean varias veces. Si no se establece LR_SHARED, una segunda llamada a CreateIconFromResourceEx para el mismo recurso creará el icono o el cursor de nuevo y devolverá un identificador diferente. Al usar esta marca, el sistema destruirá el recurso cuando ya no sea necesario. No use LR_SHARED para iconos o cursores que tengan tamaños no estándar, que pueden cambiar después de la carga o que se cargan desde un archivo.

Valor devuelto

Tipo: HICON

Si la función se ejecuta correctamente, el valor devuelto es un identificador del icono o cursor.

Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Las CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfoy LookupIconIdFromDirectoryEx permiten a las aplicaciones de shell y exploradores de iconos examinar y usar recursos en todo el sistema.

Debe llamar a DestroyIcon para iconos o destroyCursor para cursores creados con CreateIconFromResourceEx.

Ejemplos

Para obtener un ejemplo, vea Icono de uso compartido recursos.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll

Consulte también

BITMAPINFOHEADER

conceptual de

CreateIconFromResource

CreateIconIndirect

DestroyIcon

GetIconInfo

iconos

loadResource

LookupIconIdFromDirectoryEx

otros recursos

de referencia de