Функция LoadIcon.
Функция LoadIcon загружает указанный ресурс
иконки из исполняемого (.exe) файла, связанного с
экземпляром приложения.
HICON LoadIcon(
HINSTANCE hInstance,
LPCTSTR lpIconName
);
Параметры
- hInstance
- Дескриптор экземпляра модуля, исполняемый файл
которого содержит загружаемую иконку. Если
загружается стандартная иконка, то этот параметр
должен быть NULL.
- lpIconName
- Указатель на строку (завершающуюся нулём),
которая содержит имя ресурса иконки. Как
альтернатива, этот параметр может содержать
идентификатор ресурса в младшем слове и ноль в
старшем слове. Для получения этого значения
можно воспользоваться макросом MAKEINTRESOURCE.
Чтобы
загрузить одну из стандартных иконок, необходимо
установить параметр hInstance в NULL, а параметр lpIconName
в одно из следующих значений:
- IDI_APPLICATION
- Иконка приложения по умолчанию.
- IDI_ASTERISK
- Тоже что и IDI_INFORMATION.
- IDI_ERROR
- Иконка имеющая форму руки.
- IDI_EXCLAMATION
- Тоже что и IDI_WARNING.
- IDI_HAND
- Тоже что и IDI_ERROR.
- IDI_INFORMATION
- Иконка в виде звёздочки.
- IDI_QUESTION
- Иконка с вопросиком.
- IDI_WARNING
- Иконка с восклицательным знаком.
- IDI_WINLOGO
- Иконка эмблемы Windows. Windows XP: Иконка
приложения по умолчанию.
Возвращаемое значение
В случае успеха, функция вернёт дескриптор
загруженной иконки.
В случае ошибки, возвращаемое значение будет
равно NULL. Для получения более подробной
информации о ошибке, можно воспользоваться
функцией GetLastError.
Замечания
LoadIcon загружает ресурс иконки только если
она не была уже загружена, иначе функция вернёт
дескриптор на существующий ресурс. Функция ищет
ресурс иконки наиболее соответствующий текущему
дисплею. Ресурс иконки может быть как цветным так
и чёрно-белым битмапом.
LoadIcon может загружать только иконки, размер
которых соответствует системным значениям SM_CXICON
и SM_CYICON.
Информация о функции
| Заголовок |
Объявлена в Winuser.h, включена в Windows.h |
| Библиотека |
User32.lib |
| Минимальные ОС |
Включена начиная с Windows 95, Windows NT 3.1 |
| Unicode |
Windows NT, Windows 2000, Windows XP присутствует как Unicode, так
и ANSI версия |
|