Функция LookupIconIdFromDirectoryEx

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

Синтаксис

int LookupIconIdFromDirectoryEx(

    PBYTE   presbits,
    BOOL   fIcon,
    int   cxDesired,
    int   cyDesired,
    UINT   Flags
);

Параметры

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

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

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

Hosted by uCoz