Win32 API. Пиктограммы - Функция LoadIcon

Written on . Posted in Win32

ОГЛАВЛЕНИЕ

Страница 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 
Замечания по платформе  Не имеется

c++ форум