Win32 API. Пиктограммы - Функция CreateIcon

Функция CreateIcon

(СоздатьПиктограмму)

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

Синтаксис

HICON CreateIcon
{
 HINSTANCE hInstance, // дескриптор экземпляра приложения
 int nWidth,  // ширина пиктограммы
 int nHeight,  // высота пиктограммы
 BYTE cPlanes,  // число плоскостей в битовой маске XOR
 BYTE cBitsPixel,  // число битов на пиксель в битовой маске XOR
 CONST BYTE *lpbANDbits, // указатель на массив битовой маски AND
 CONST BYTE *lpbXORbits // указатель на массив битовой маски XOR
);

Параметры

hInstance
Идентифицирует экземпляр модуля, создающего пиктограмму.
nWidth
Определяет ширину пиктограммы, в пикселях.
nHeight
Определяет высоту пиктограммы, в пикселях.
cPlanes
Определяет число плоскостей в битовой маске XOR пиктограммы.
cBitsPixel
Определяет число битов на пиксель в битовой маске XOR пиктограммы.
lpbANDbits
Указывает на массив байтов, который содержит битовые значения для битовой маски AND пиктограммы. Эта битовая маска описывает одноцветный точечный рисунок.
lpbXORbits
Указывает на массив байтов, который содержит битовые значения для битовой маски XOR пиктограммы. Эта битовая маска описывает одноцветный или аппаратно-зависимый цветной точечный рисунок.

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

Если функция завершается успешно, величина возвращаемого значения - дескриптор пиктограммы.
Если функция не выполняет задачу, величина возвращаемого значения ПУСТО (NULL). Чтобы получать расширенные данные об ошибках, вызовите GetLastError.

Замечания

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

Битовая маска AND	Битовая маска XOR	Изображение
0	0	Черное
0	1	Белое
1	0	Экранное
1	1	Обратное экранному

Смотри также

GetSystemMetrics

Размещение и совместимость CreateIcon

Windows NT    Да 
Win95     Да 
Win32s     Да 
Импортируемая библиотека   user32.lib
Заголовочный файл    winuser.h
Уникод     Нет 
Замечания по платформе   Не имеется