Функция 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 | ||
Замечания по платформе | Не имеется |