Функция LookupIconIdFromDirectory

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

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

Синтаксис

int LookupIconIdFromDirectory(

     PBYTE   presbits,
     BOOL   fIcon
);

Параметры

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

Размещение и совместимость LookupIconIdFromDirectory
К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.1 и выше
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
С Windows 2003 Server Да
е Windows 2000 Server Да
р Windows NT Server Да версии 3.1 и выше
в
е
р
Используемая библиотека User32.lib
Используемая DLL user32.dll
Заголовочный файл
- объявлено в Winuser.h
- включено в Windows.h
Unicode
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz