8.10.1.12 - Функция LookupIconIdFromDirectoryEx

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

[Теперь поддерживается Windows NT]

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

Синтаксис

int LookupIconIdFromDirectoryEx
(
	PBYTE presbits,	// адрес данных ресурса
	BOOL fIcon,	// флажок пиктограммы или курсора
	int cxDesired,	// желаемая ширина пиктограммы или курсора
	int cyDesired,	// желаемая высота пиктограммы или курсора
	UINT Flags	// флажки ресурса
);

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

Флажок 			Что он означает
LR_DEFAULTCOLOR		Использует заданный по умолчанию формат цвета.
LR_MONOCHROME		Создает одноцветную пиктограмму или курсор.

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

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

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

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

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

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