Win32 API. Пиктограммы
Страница 15. Функция CreateIconFromResourceEx


Функция CreateIconFromResourceEx

(СоздатьПиктограммуИзРесурсаРасширенная)

[Теперь поддерживается в Windows NT]

Функция CreateIconFromResourceEx создает пиктограмму или курсор из битов ресурса, описывающих пиктограмму.

Синтаксис

HICON CreateIconFromResourceEx
(
PBYTE pbIconBits,// указатель на биты пиктограммы или курсора
DWORD cbIconBits,// число байтов в буфере битов
BOOL fIcon,// флажок пиктограммы или курсора
DWORD dwVersion,// версия формата Windows
int cxDesired,// желаемая ширина пиктограммы или курсора
int cyDesired,// желаемая высота пиктограммы или курсора
UINT uFlags// флажки загружаемого ресурса
);

Параметры
pbIconBits
Указывает на буфер, содержащий биты ресурса пиктограммы или курсора. Эти биты обычно загружаются при помощи вызова функций LookupIconIdFromDirectoryEx и LoadResource.
cbIconBits
Определяет размер, в байтах, набора битов, указанных параметром pbIconBits.
fIcon
Определяет, что должно быть создано - пиктограмма или курсор. Если этот параметр - ИСТИНА (TRUE), должна быть создана пиктограмма. Если это - ЛОЖЬ (FALSE), должен быть создан курсор.
dwVersion
Определяет номер версии формата пиктограммы или курсора для битов ресурса, указанных параметром pbIconBits. Этот параметр может быть одним из следующих значений:

Формат dwVersion
Windows 2.x0x00020000
Windows 3.x0x00030000

Все прикладные программы, базирующиеся на Win32, используют формат Windows 3.x для пиктограмм и курсоров.
cxDesired
Определяет желаемую ширину, в пикселях, пиктограммы или курсора. Если этот параметр нулевой, функция использует, чтобы установить ширину, значение показателя системы SM_CXICON или SM_CXCURSOR.
cyDesired
Определяет желаемую высоту, в пикселях, пиктограммы или курсора. Если этот параметр нулевой, функция использует, чтобы установить высоту, значение показателя системы SM_CYICON или SM_CYCURSOR.
uFlags
Определяет комбинацию следующих значений:

  • LR_DEFAULTCOLOR - Использует заданный по умолчанию формат цвета.
  • LR_MONOCHROME - Создает одноцветную пиктограмму или курсор.

Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - дескриптор пиктограммы или курсора.
Если функция не выполняет задачу, величина возвращаемого значения - ПУСТО (NULL). Чтобы получать расширенные данные об ошибках, вызовите GetLastError.

Замечания
Функции CreateIconFromResourceEx, CreateIconFromResource, CreateIconIndirect, GetIconInfo и LookupIconIdFromDirectoryEx позволяют оболочке прикладной программы и программе просмотра пиктограммы проверять и использовать ресурсы по всей системе.

Смотри также
BITMAPINFOHEADER, CreateIconFromResource, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectoryEx

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

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

 
« Предыдущая статья   Следующая статья »