Функция LookupIconIdFromDirectoryEx

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

Синтаксис

Параметры

presbits

[in] Указатель на данные значка или каталог курсора. Поскольку эта функция не проверяет допустимость данных ресурса, это может стать причиной общего нарушения защиты (GP) или возврата неопределенного значения, если параметр presbits не указывает на допустимые данные ресурса.

fIcon

[in] Устанавливает, что искать - значок или курсор. Если этот параметр - ИСТИНА (TRUE), функция ищет значок; если параметр - ЛОЖЬ (FALSE), функция ищет курсор.

cxDesired

[in] Устанавливает желательную ширину значка, в пикселях. Если этот параметр - нуль, функция использует системное метрическое значение SM_CXICON или SM_CXCURSOR.

cyDesired

[in] Устанавливает желательную высоту значка, в пикселях. Если этот параметр - нуль, функция использует системное метрическое значение SM_CYICON или SM_CYCURSOR.

Flags

[in] Устанавливает комбинацию нижеследующих значений:

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

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

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

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

Замечания

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

Каталог значка загружается из файла ресурса при помощи ресурса типа RT_GROUP_ICON (или RT_GROUP_CURSOR для курсоров) и целочисленного имени ресурса для указанного значка, который будет загружен. Функция LookupIconIdFromDirectoryEx возвращает целочисленный идентификатор, являющийся именем ресурса значка, который лучше всего подходит текущему устройству отображения.

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

Пример смотри в статье Совместное использование ресурсов значка.

Смотри также

Обзор Значки, Функции, используемые значками, CreateIconFromResourceEx, CreateIconIndirect, FindResource, FindResourceEx, GetIconInfo, LoadCursor, LoadIcon, LoadImage, LookupIconIdFromDirectory, MAKEINTRESOURCE