CreateIcon

Функция 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 .