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

Written on . Posted in Win32

ОГЛАВЛЕНИЕ

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

Функция 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.x 0x00020000
Windows 3.x 0x00030000

Все прикладные программы, базирующиеся на 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
Уникод    Нет 
Замечания по платформе  Не имеется

c++ форум