(СоздатьПиктограмму)
Функция 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 Уникод Нет Замечания по платформе Не имеется