8.10.1.2 - Функция 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Изображение
00Черное
01Белое
10Экранное
11Обратное экранному

Смотри также
GetSystemMetrics

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

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

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков - 28.06.2002