8.10.1.11 - Функция LookupIconIdFromDirectory

(ПодстановкаПиктограммыИзКаталога)

Функция LookupIconIdFromDirectory ищет среди пиктограмм или курсоров данные, которые лучше всего соответствует текущему устройству отображения.

Синтаксис

int LookupIconIdFromDirectory
(
	PBYTE presbits,	// адрес ресурса с данными
	BOOL fIcon	// внешний вид иконы или курсора
);

Параметры
presbits
Указывает на каталог данных пиктограммы или курсора. Так как эта функция не проверяет правильность данных ресурса, она может стать причиной ошибки общей защиты (GP) или возвращает неопределенное значение, если presbits указывает на не правильные данные ресурса.
fIcon
Определяет, что разыскивается, пиктограмма или курсор. Если этот параметр - ИСТИНА (TRUE), функция ищет пиктограмму; если параметр - ЛОЖЬ (FALSE), функция ищет курсор.

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

Замечания
Файл ресурса типа RT_GROUP_ICON (RT_GROUP_CURSOR обозначающий курсоры) содержит данные пиктограммы (или курсора) в нескольких аппаратно-зависимых и не зависящих от устройства форматах. LookupIconIdFromDirectory ищет файл ресурса пиктограммы (или курсора), которые лучше всего соответствуют текущему устройству отображения и возвращает целочисленный идентификатор. Функции FindResource и FindResourceEx с этим идентификатором используют макрокоманду MAKEINTRESOURCE, чтобы определить ресурс в модуле.
Каталог пиктограммы загружается из файла ресурса с типом ресурса RT_GROUP_ICON (или RT_GROUP_CURSOR для курсоров) и целочисленным значением названия ресурса для конкретной пиктограммы, которая будет загружена. LookupIconIdFromDirectory возвращает целочисленный идентификатор, который является названием ресурса пиктограммы, которая лучше всего соответствует текущему устройству отображения.
Функции LoadIcon, LoadCursor и LoadImageWindows 95) используют эту функцию, чтобы найти заданные данные ресурса для пиктограммы или курсора, которые лучше всего соответствуют текущему устройству отображения.

Смотри также
CreateIconFromResource, CreateIconIndirect, FindResource, FindResourceEx, GetIconInfo, LoadCursor, LoadIcon, LoadImage, LookupIconIdFromDirectoryEx, MAKEINTRESOURCE

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

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

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков - 29.06.2002