Función CreateIconFromResourceEx (winuser.h)

Artículo
01/27/2024

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

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

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

[in] dwResSize

Tipo: DWORD

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

[in] fIcon

Tipo: BOOL

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 el punto de acceso del cursor y es el primer dato leído de los bits de recursos del cursor.

[in] dwVer

Tipo: DWORD

Número de versión del formato de icono o cursor 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 SM_CXICON o SM_CXCURSOR valor de métrica del sistema 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 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. Cuando se usa esta marca, el sistema destruirá el recurso cuando ya no sea necesario. No use LR_SHARED para iconos o cursores que tienen 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 la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Las funciones CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo y LookupIconIdFromDirectoryEx permiten que las aplicaciones de shell y los exploradores de iconos examinen y usen recursos en todo el sistema.

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

Ejemplos

Para obtener un ejemplo, vea Compartir recursos de icono.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll