Функция CreateSolidBrush (wingdi.h)

  • Статья

Функция CreateSolidBrush создает логическую кисть с указанным сплошным цветом.

Синтаксис

HBRUSH CreateSolidBrush(
  [in] COLORREF color
);

Параметры

[in] color

Цвет кисти. Чтобы создать значение цвета COLORREF , используйте макрос RGB .

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

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

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

Комментарии

Если объект HBRUSH больше не нужен, вызовите функцию DeleteObject , чтобы удалить его.

Сплошная кисть — это растровое изображение, которое система использует для рисования внутренних элементов заполненных фигур.

После того как приложение создаст кисть, вызвав CreateSolidBrush, оно может выбрать ее в любом контексте устройства, вызвав функцию SelectObject .

Для рисования системной цветовой кистью приложение должно использовать GetSysColorBrush (nIndex) вместо CreateSolidBrush(GetSysColor(nIndex)), так как GetSysColorBrush возвращает кэшированную кисть вместо выделения новой.

ICM: При создании кисти управление цветом не выполняется. Однако управление цветом выполняется при выборе кисти в контексте устройства с поддержкой ICM.

Примеры

Пример см. в разделе Создание цветных перьев и кистей.

Требования

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

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

Функции кисти

Обзор кистей

COLORREF

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateHatchBrush

CreatePatternBrush

DeleteObject

GetSysColorBrush

RGB

SelectObject