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.