Win32 API. Пиктограммы - Функция LookupIconIdFromDirectory

Written on . Posted in Win32

ОГЛАВЛЕНИЕ

Страница 22 из 30

Функция LookupIconIdFromDirectory

(ПодстановкаПиктограммыИзКаталога)

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

Синтаксис

int LookupIconIdFromDirectory
(
 PBYTE presbits, // адрес ресурса с данными
 BOOL fIcon // внешний вид иконы или курсора
);

Параметры

presbits
Указывает на каталог данных пиктограммы или курсора. Так как эта функция не проверяет правильность данных ресурса, она может стать причиной ошибки общей защиты (GP) или возвращает неопределенное значение, если presbits указывает на не правильные данные ресурса.
fIcon
Определяет, что разыскивается, пиктограмма или курсор. Если этот параметр - ИСТИНА (TRUE), функция ищет пиктограмму; если параметр - ЛОЖЬ (FALSE), функция ищет курсор.

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

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

Замечания

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

Смотри также

CreateIconFromResource, CreateIconIndirect, FindResource, FindResourceEx, GetIconInfo, LoadCursor, LoadIcon, LoadImage, LookupIconIdFromDirectoryEx, MAKEINTRESOURCE

Размещение и совместимость LookupIconIdFromDirectory

Windows NT   Да 
Win95    Да 
Win32s    Да 
Импортируемая библиотека  user32.lib
Заголовочный файл   winuser.h
Уникод    Нет 
Замечания по платформе  Не имеется

c++ форум