Win32 API. Пиктограммы
Страница 21. Функция LoadIcon
Страница 21 из 30

Функция LoadIcon

(ЗагрузитьПиктограмму)

Функция LoadIcon загружает определяемый ресурс пиктограммы из исполняемого (.EXE) файла, связанного с экземпляром прикладной программы.

Синтаксис 

HICON LoadIcon
(
HINSTANCE hInstance,// дескриптор экземпляра приложения
LPCTSTR lpIconName // строка с именем или идентификатор ресурса пиктограммы
);

Параметры
hInstance
Идентифицирует экземпляр модуля, исполняемый файл которого содержит пиктограмму, которая будет загружена. Этот параметр должен иметь значение ПУСТО (NULL), когда загружается стандартная пиктограмма.
lpIconName
Указывает на строку с символом нуля в конце, которая содержит название ресурса пиктограммы, которая будет загружена. Альтернативно, этот параметр может содержать идентификатор ресурса в младшем слове и нули в старшем слове. Используйте макрокоманду MAKEINTRESOURCE, чтобы создать это значение.
Чтобы использовать одну из предопределенных пиктограмм Windows, установите параметр hInstance в значение ПУСТО (NULL), а параметр lpIconName в одно из следующих значений:

  • IDI_APPLICATION - Пиктограмма приложения по умолчанию.
  • IDI_ASTERISK - Звездочка (используется в информационных сообщениях).
  • IDI_EXCLAMATION - Восклицательный знак (используется в предупреждающих сообщениях).
  • IDI_HAND - Пиктограмма, имеющая форму руки (используется в серьезных предупреждающих сообщениях).
  • IDI_QUESTION - Вопросительный знак (используется в подсказках).
  • IDI_WINLOGO - Логотип Windows.

Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - дескриптор недавно загруженной пиктограммы.
Если функция не выполняет задачу, величина возвращаемого значения - ПУСТО (NULL). Чтобы получать расширенные данные об ошибках, вызовите GetLastError.

Замечания
LoadIcon загружает ресурс пиктограммы, только в том случае, если он не был загружен; иначе, функция получает дескриптор существующего ресурса. Функция ищет ресурс пиктограммы, которая наиболее соответствует для текущего дисплея. Ресурс пиктограммы может быть цветной или одноцветный точечный рисунок.
LoadIcon может загрузить только пиктограмму, размер которой соответствует метрическим значениям системы SM_CXICON и SM_CYICON. Используйте функцию LoadImage, чтобы загружать пиктограммы, которые другого размера.

Смотри также
CreateIcon, LoadImage, MAKEINTRESOURCE

Размещение и совместимость LoadIcon

Windows NTДа 
Win95Да 
Win32sДа 
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
УникодWinNT 
Замечания по платформеНе имеется
 
« Предыдущая статья   Следующая статья »