Función CreateIconFromResource (winuser.h)

Artículo
01/27/2024

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

Para especificar un alto o ancho deseado, use la función CreateIconFromResourceEx .

Sintaxis

HICON CreateIconFromResource(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer
);

Parámetros

[in] presbits

Tipo: PBYTE

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

Consulte 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 presbits .

[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.

Valor devuelto

Tipo: HICON

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el icono o el 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, LookupIconIdFromDirectory y LookupIconIdFromDirectoryEx permiten a las aplicaciones de shell y exploradores de iconos examinar y usar recursos en todo el sistema.

La función CreateIconFromResource llama a CreateIconFromResourceEx pasando LR_DEFAULTSIZE|LR_SHARED como marcas.

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

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 (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll