Функция LookupIconIdFromDirectory (winuser.h)

Статья
05/25/2023

Выполняет поиск значка (RT_GROUP_ICON) или курсора (RT_GROUP_CURSOR) для значка или курсора, наиболее подходящего для текущего устройства отображения.

Чтобы указать нужную высоту или ширину, используйте функцию LookupIconIdFromDirectoryEx . Эта функция вызывает ее путем передачи нуля в параметрах cxDesired/cyDesired .

Синтаксис

int LookupIconIdFromDirectory(
  [in] PBYTE presbits,
  [in] BOOL  fIcon
);

Параметры

[in] presbits

Тип: PBYTE

Значок или данные каталога курсора. Так как эта функция не проверяет данные ресурса, она вызывает сбой общей защиты (GP) или возвращает неопределенное значение, если presbits не указывает на допустимые данные ресурса.

[in] fIcon

Тип: BOOL

Указывает, ищется ли значок или курсор. Если этот параметр имеет значение TRUE, функция ищет значок; Если параметр имеет значение FALSE, функция выполняет поиск курсора.

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

Тип: int

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll