LoadIcon

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

() HICON LoadIcon HINSTANCE  hInstance, / / обработать для экземпляра приложенияLPCTSTRlpIconName / / имя значка строки или значка ресурс / / идентификатор);

Параметры

hInstance

Дескриптор экземпляра модуля, чьи исполняемый файл содержит значок, чтобы быть загружены. Этот параметр должен иметь значение NULL, при загрузке стандартный значок.

lpIconName

Указатель на ограниченную значением null строку, содержащую имя ресурса значка для загрузки. Кроме того этот параметр может содержать идентификатор ресурса в слове, младший и ноль в старшее слово. Для создания этого значения использовать макрос 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.

Значение	Описание
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.

Возвращаемые значения

Если функция выполнена успешно, возвращаемое значение является дескриптором для недавно загруженных значок.

Если вызов функции был неуспешен, возвращается значение NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

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

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

Windows CE: Стандартные значки (IDI_ *) не поддерживаются.

В Windows CE 1.0 значок должен быть двух бит на пиксел (.ic2) значок или монохромный значок.

Родственные слова

Обзор значков, LoadImage значок функции, CreateIcon,MAKEINTRESOURCE

Index