Функция CreateIcon (winuser.h)

Статья
01/27/2024

Создает значок, имеющий указанный размер, цвета и битовые узоры.

Чтобы создать цветной значок во время выполнения, можно использовать функцию CreateIconIndirect , которая создает значок на основе содержимого структуры ICONINFO .

Синтаксис

HICON CreateIcon(
  [in, optional] HINSTANCE  hInstance,
  [in]           int        nWidth,
  [in]           int        nHeight,
  [in]           BYTE       cPlanes,
  [in]           BYTE       cBitsPixel,
  [in]           const BYTE *lpbANDbits,
  [in]           const BYTE *lpbXORbits
);

Параметры

[in, optional] hInstance

Тип: HINSTANCE

Дескриптор экземпляра модуля, создающего значок.

[in] nWidth

Тип: int

Ширина значка в пикселях. См. примечания.

[in] nHeight

Тип: int

Высота значка в пикселях. См. примечания.

[in] cPlanes

Тип: BYTE

Количество плоскостей в битовой маске XOR значка. См. примечания.

[in] cBitsPixel

Тип: BYTE

Число битов на пиксель в битовой маске XOR значка.

[in] lpbANDbits

Тип: const BYTE*

Массив байтов, содержащий битовые значения для битовой маски И значка. Эта битовая маска описывает монохромное растровое изображение. См. примечания.

[in] lpbXORbits

Тип: const BYTE*

Массив байтов, содержащий битовые значения для битовой маски XOR значка. Эта битовая маска описывает монохромное или цветовое растровое изображение. См. примечания.

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

Тип: HICON

Если функция выполняется успешно, возвращаемое значение является дескриптором значка.

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Чтобы определить номинальный размер значка, используйте функцию GetSystemMetrics , указав значение SM_CXICON или SM_CYICON . Кроме того, вы можете использовать версию этого API с поддержкой DPI, см. раздел (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Дополнительные сведения см. в статье Размеры значков и разработка классических приложений с высоким разрешением в Windows.

Дополнительные сведения о параметрах lpbANDbits и lpbXORbits см. в описании параметра lpBits функции CreateBitmap .

В случае монохромного значка CreateIcon применяет следующую таблицу истинности к битовой маске AND и XOR:

Битовая маска AND	Битовая маска XOR	Отображение
0	0	Черный
0	1	White
1	0	Screen
1	1	Экран "Обратный"

Завершив использование значка, удалите его с помощью функции DestroyIcon .

Примеры

Пример см. в разделе Создание значка.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll

См. также раздел

CreateIconIndirect

Значки

Размеры значков

Поделиться через