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

Функция CreateIconсоздает иконку, которая имеет указанные размер, цвета и битовые шаблоны.

HICON CreateIcon(

HINSTANCE hInstance , // дескриптор экземпляра приложения

int nWidth , // ширина иконки

int nHeight , // высота иконки

BYTE cPlanes , // число плоскостей в битовой маске исключающее ИЛИ

BYTE cBitsPixel , // число бит на пиксель

// в битовой маске исключающее ИЛИ

CONST BYTE* lpbANDbits , // указатель на массив битовой маски И

CONST BYTE* lpbXORbits // указатель на массив битовой маски ИЛИ

);

Параметры

hInstance - идентифицирует экземпляр модуля, создающего иконку.

nWidth - определяет ширину иконки в пикселях.

nHeight - определяет высоту иконки в пикселях.

cPlanes - определяет число плоскостей в битовой маске исключающее ИЛИ иконки.

cBitsPixel - определяет число бит на пиксель в битовой маске исключающее ИЛИ иконки.

lpbANDbits - указатель на массив байт, который содержит битовые значения для маски И иконки. Такая битовая маска описывает монохромное изображение.

lpbXORbits - указатель на массив байт, который содержит битовые значения для маски исключающее ИЛИ иконки. Такая битовая маска описывает зависимое от устройства цветное изображение.

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

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

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

Комментарии

Значения параметров nWidth и nHeight должны указывать ширину и высоту, поддерживаемые текущим драйвером дисплея, потому что система не может создать иконки других размеров. Для определения того, какие ширина и высота поддерживаются драйвером дисплея, вызовите функцию GetSystemMetrics, указав значения SM _ CXICON и SM _ CYICON .

CreateIconприменяет следующую таблицу истинности для битовых масок.

См. также

GetSystemMetrics.

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

HICON CreateIconFromResource(

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

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

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

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

);

Параметры

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

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

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

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

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

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

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

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

Комментарии

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

См. также

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

Функция 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 . Параметр может принимать одно из следующих значений:

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

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

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

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

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

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

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

Комментарии

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