Функция CreateIcon создает значок, который имеет заданный размер, цвета и битовые узоры.
Синтаксис
HICON CreateIcon( HINSTANCE hInstance, int nWidth, int nHeight, BYTE cPlanes, BYTE cBitsPixel, const BYTE *lpbANDbits, const BYTE *lpbXORbits ); |
Параметры
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
Размещение и совместимость CreateIcon | ||
К | Windows XP | Да |
л | Windows 2000 Professional | Да |
и | Windows NT Workstation | Да версии 3.1 и выше |
е | Windows Me | Да |
н | Windows 98 | Да |
т | Windows 95 | Да |
С | Windows 2003 Server | Да |
е | Windows 2000 Server | Да |
р | Windows NT Server | Да версии 3.1 и выше |
в | ||
е | ||
р | ||
Используемая библиотека | User32.lib | |
Используемая DLL | user32.dll | |
Заголовочный файл | ||
- объявлено в | Winuser.h | |
- включено в | Windows.h | |
Unicode | ||
Замечания по платформе | Не имеется |