15 мая 2023 года "Исходники.РУ" отмечают своё 23-летие!
Поздравляем всех причастных и неравнодушных с этим событием!
И огромное спасибо всем, кто был и остаётся с нами все эти годы!

Главная Форум Журнал Wiki DRKB Discuz!ML Помощь проекту


Функция 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 версия