Русский справочник по Win32 API

DWORD dwVer // версия формата Windows

);

Параметры

presbits - указывает на буфер, содержащий биты ресурса иконки или курсора. Эти биты обычно загружаются вызовами функций LookupIconIdFromDirectory (в Windows 95 вы также можете использовать функцию LookupIconIdFromDirectoryEx ) и LoadResource .

dwResSize - определяет размер, в байтах, набора битов, на который указывает параметр presbits .

fIcon - определяет, будет ли создаваться иконка или курсор. Если значение этого параметра равно TRUE, создается иконка. Иначе создается курсор.

dwVer - определяет номер версии формата иконки или курсора для битов ресурса, на которые указывает параметр presbits . Параметр может принимать одно из следующих значений:

Формат	Значение
Windows 2. x	0x00020000
Windows 3.x	0x00030000

Все Win 32 приложения должны использовать для иконок и курсоров формат Windows 3. x .

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

В случае успеха возвращается дескриптор иконки или курсора.

В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .

Комментарии

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

См. также

CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx .

CreateIconFromResourceEx

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

HICON CreateIconFromResourceEx (

PBYTE pbIconBits , // указатель на биты ресурса

DWORD cbIconBits , // число бит в буфере

BOOL fIcon , // флаг иконки или курсора

DWORD dwVersion , // версия формата Windows

int cxDesired , // желаемая ширина иконки или курсора

int cyDesired , // желаемая высота иконки или курсора

UINT uFlags

);

Параметры

pbIconBits - указывает на буфер, содержащий биты ресурса иконки или курсора. Эти биты обычно загружаются вызовами функций LookupIconIdFromDirectory (в Windows 95 вы также можете использовать функцию LookupIconIdFromDirectoryEx ) и LoadResource .

cbIconBits - определяет размер, в байтах, набора битов, на который указывает параметр pbIconBits .

fIcon - определяет, будет ли создаваться иконка или курсор. Если значение этого параметра равно TRUE, создается иконка. Иначе создается курсор.

dwVersion - определяет номер версии формата иконки или курсора для битов ресурса, на которые указывает параметр pbIconBits . Параметр может принимать одно из следующих значений:

Формат	Значение
Windows 2. x	0x00020000
Windows 3.x	0x00030000

Все Win 32 приложения должны использовать для иконок и курсоров формат Windows 3. x .

cxDesired

- определяет желаемую ширину иконки или курсора в пикселях. Если значение этого параметра равно нулю, функция использует значения метрики системы SM _ CXICON или SM _ CXCURSOR для установки ширины.

cyDesired - определяет желаемую высоту иконки или курсора в пикселях. Если значение этого параметра равно нулю, функция использует значения метрики системы SM _ CXICON или SM _ CXCURSOR для установки высоты.

uFlags - определяет комбинацию из следующих значений:

Значение	Пояснение
LR _ DEFAULTCOLOR	Используется цветовой формат по умолчанию.
LR _ MONOCHROME	Создается монохромная иконка или курсор.

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

В случае успеха возвращается дескриптор иконки или курсора.

В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .

Комментарии

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

См. также