winuser.h


CreateIconFromResourceEx

[Ahora también soportado en Windows NT]

La función CreateIconFromResourceEx crea un incono o cursor a partir de los bits de recurso que describen el icono.

Sintaxis

HICON CreateIconFromResourceEx(
    PBYTE pbIconBits,  // puntero a bits del icono o cursor
    DWORD cbIconBits,  // número de bytes en el buffer de bits
    BOOL fIcon,        // bandera de icono o cursor
    DWORD dwVersion,   // versión de formato de Windows
    int cxDesired,     // anchura deseada del icono o cursor
    int cyDesired,     // altura deseada del icono o cursor
    UINT uFlags        // banderas de carga del recurso
   );

Parámetros

pbIconBits: puntero a buffer que contiene los bits de recurso del icono o cursor. Estos bits se obtienen normalmente por llamadas a las funciones LookupIconIdFromDirectoryEx) y LoadResource.

dwResSize: especifica el tamaño, en bytes, de el conjunto de bits apuntados por el parámetro pbIconBits.

fIcon: especifica si se trata de crear un icono o un cursor. Si este parámetro es TRUE, se creará un icono. Si es FALSE, se crerá un cursor.

dwVer: especifica el número de versión del formato de icono o cursor para los bits de recurso apuntados por el parámetro presbits. Este parámetro puede tomar uno de los siguientes valores:

Formato dwVer
Windows 2.x 0x00020000
Windows 3.x 0x00030000

Todas las aplicaciones basadas en Win32 usan el formato Windows 3.x para iconos y cursores.

cxDesired: especifica la anchura deseada, en pixels, del icono o cursor. Si este parámetro es cero, la función usa los valores de medidas del sistema SM_CXICON o SM_CXCURSOR para el ancho.

cyDesired: especifica la altura deseada, en pixels, del icono o cursor. Si este parámetro es cero, la función usa los valores de medidas del sistema SM_CYICON o SM_CYCURSOR para la altura.

uFlags: especifica una combinación de los siguientes valores:

Valor Significado
LR_DEFAULTCOLOR Usa el formato de color por defecto.
LR_MONOCHROME Crea un icono o cursor monocromo.

Valor de retorno

Si la función tiene éxito, el valor de retorno será un manipulador al icono o cursor.

Si la función falla, el valor de retorno es NULL. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

Las funciones CreateIconFromResourceEx, CreateIconFromResource, CreateIconIndirect, GetIconInfo y LookupIconIdFromDirectoryEx) permiten a aplicaciones shell y a navegadores de iconos examinar y usar recursos de todo el sistema.