Функция CreateIcon

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

Синтаксис

Параметры

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