Win32 API. Пиктограммы
Страница 13. Функция 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
УникодНет
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »