(СоздатьПиктограммуИзРесурсаРасширенная)
[Теперь поддерживается в 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
Определяет комбинацию следующих значений:
Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - дескриптор пиктограммы или курсора.
Если функция не выполняет задачу, величина возвращаемого значения - ПУСТО (NULL). Чтобы получать расширенные данные об ошибках, вызовите GetLastError.
Замечания
Функции CreateIconFromResourceEx, CreateIconFromResource, CreateIconIndirect, GetIconInfo и LookupIconIdFromDirectoryEx позволяют оболочке прикладной программы и программе просмотра пиктограммы проверять и использовать ресурсы по всей системе.
Смотри также
BITMAPINFOHEADER, CreateIconFromResource, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectoryEx
Размещение и совместимость CreateIconFromResourceEx
Windows NT Да Win95 Да Win32s Нет Импортируемая библиотека user32.lib Заголовочный файл winuser.h Уникод Нет Замечания по платформе Не имеется