winuser.h


LoadIcon

La función LoadIcon carga el recurso de icono especificado desde el fichero ejecutable (.EXE) asociado con una instancia de aplicación.

Sintaxis

HICON LoadIcon(
    HINSTANCE hInstance,  // manipulador de instancia de aplicación
    LPCTSTR lpIconName    // cadena con nombre de icono o identidicador de recurso de icono
   );

Parámetros

hInstance: identifica una onstancia del módulo cuyo fichero ejecutable contiene el icono a cargar. Este parámetros debe ser NULL cuando se quiera cargar un icono estándar.

lpIconName: puntero a una cadena terminada con cero que contiene el nombre del recurso de icono a cargar. Alternativamente, este parámetro puede contener un identificador de recurso en la palabra de menor peso y cero en la palabra de mayor peso. Usar la macro MAKEINTRESOURCE para crear este valor.

Para usar uno de los iconos de Windows predefinidos, usar NULL para el parámetro hInstance y para el parámetro lpIconName uno de los siguientes valores:

Valor Descripción
IDI_APPLICATION Icono de aplicación por defecto.
IDI_ASTERISK Asterisco (usado en mensajes de información).
IDI_EXCLAMATION Signo de exclamación (usado en mensajes de aviso).
IDI_HAND Icono de mano extentida (usado en mensajes de aviso importantes).
IDI_QUESTION Signo de interrogación (usado en mensajes de petición de datos).
IDI_WINLOGO Icono de logo de Windows.

Valor de retorno

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

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

Observaciones

LoadIcon carga el recurso de icono sólo si no ha sido cargado ya; en otro caso, recupera un manipulador al recurso existente. La función busca en el recurso de icono el icono más apropiado para la pantalla actual. El recurso de icono puede ser un mapa de bits en color o monocromo.

LoadIcon sólo puede cargar un icono cuyo tamaño coincida con los valores SM_CXICON y SM_CYICON de la métrica del sistema. Usar la función LoadImage para cargar iconos de otros tamaños.