Функция CreateIcon

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

Синтаксис

HICON CreateIcon(

    HINSTANCE hInstance,
    int nWidth,
    int nHeight,
    BYTE cPlanes,
    BYTE cBitsPixel,
    const BYTE *lpbANDbits,
    const BYTE *lpbXORbits
);

Параметры

hInstance

[in] Дескриптор экземпляра модуля, создающего значок.

nWidth

[in] Определяет ширину значка, в пикселях.

nHeight

[in] Определяет высоту значка, в пикселях.

cPlanes

[in] Определяет число плоскостей в битовой маске XOR значка.

cBitsPixel

[in] Определяет число битов на пиксель в битовой маске XOR значка.

lpbANDbits

[in] Указатель на массив байтов, который содержит битовые значения для битовой маски AND значка. Эта битовая маска описывает монохромный точечный рисунок.

lpbXORbits

[in] Указатель на массив байтов, который содержит битовые значения для битовой маски XOR значка. Эта битовая маска описывает монохромный или зависимый от устройства цветной точечный рисунок.

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

Если функция завершается успешно, возвращаемое значение - дескриптор значка.

Если функция завершается ошибкой, возвращаемое значение - НУЛЬ (NULL). Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Параметры nWidth и nHeight должны определять ширину и высоту, поддерживаемую текущим драйвером монитора, потому что система не может создавать значки других размеров. Чтобы определить ширину и высоту, поддерживаемую драйвером монитор, используйте функцию GetSystemMetrics, определяя значение SM_CXICON или SM_CYICON.

Функция CreateIcon применяет нижеследующую таблицу истинности к битовым маскам AND и XOR:

AND

битовая маска

XOR

битовая маска

Цвет на экране
0 0 Черный (Black)
0 1 Белый (White)
1 0 Цвет кадра (Screen)
1 1 Обратный цвету кадра (Reverse screen)

Пример

Пример смотри в статье Создание значка (пример).

Смотри также

Обзор Значки, Функции, используемые значкамиGetSystemMetrics

Размещение и совместимость CreateIcon
К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.1 и выше
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
С Windows 2003 Server Да
е Windows 2000 Server Да
р Windows NT Server Да версии 3.1 и выше
в
е
р
Используемая библиотека User32.lib
Используемая DLL user32.dll
Заголовочный файл
- объявлено в Winuser.h
- включено в Windows.h
Unicode
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz