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

Written on . Posted in Win32

ОГЛАВЛЕНИЕ

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

Функция CreateIconFromResource

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

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

Синтаксис

HICON CreateIconFromResource
(
 PBYTE presbits, // указатель на биты пиктограммы или курсора
 DWORD dwResSize, // число байтов в буфере битов
 BOOL fIcon, // флажок пиктограммы или курсора
 DWORD dwVer // версия формата Windows
);

Параметры

presbits
Указывает на буфер, содержащий биты ресурса пиктограммы или курсора. Эти биты обычно загружаются при помощи вызова функций LookupIconIdFromDirectory (в Windows 95, Вы можете также вызвать LookupIconIdFromDirectoryEx) и LoadResource.
dwResSize
Определяет размер, в байтах, набор битов, указанных параметром presbits.
fIcon
Определяет, что должно быть создано - пиктограмма или курсор. Если этот параметр - ИСТИНА (TRUE), должна быть создана пиктограмма. Если он - ЛОЖЬ (FALSE), должен быть создан курсор.
dwVer
Определяет номер версии формата пиктограммы или курсора для битов ресурса, указанных параметром presbits. Этот параметр может быть одним из следующих значений: 
Формат  dwVer
Windows 2.x 0x00020000
Windows 3.x 0x00030000

Все прикладные программы, базирующиеся на Microsoft Win32, использует для пиктограмм и курсоров формат Windows 3.x.

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

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

Замечания

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

Смотри также

CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx

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

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

c++ форум