Функция LookupIconIdFromDirectory

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

Чтобы установить желательную высоту или ширину, используйте функцию LookupIconIdFromDirectoryEx.

Синтаксис

Параметры

presbits

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

fIcon

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

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

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

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

Замечания

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

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

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

Смотри также

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