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


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

Функция SetDCBrushColor задает для текущего цвета кисти контекста устройства (DC) указанное значение цвета. Если устройство не может представить указанное значение цвета, для цвета устанавливается ближайший физический цвет.

Синтаксис

COLORREF SetDCBrushColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Параметры

[in] hdc

Дескриптор контроллера домена.

[in] color

Новый цвет кисти.

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

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

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

Комментарии

При выборе DC_BRUSH в контроллере домена все последующие рисунки будут выполняться с помощью цвета кисти dc до тех пор, пока не будет отменен выбор штоковой кисти. Цвет DC_BRUSH по умолчанию — WHITE.

Функция возвращает предыдущий цвет DC_BRUSH, даже если в контроллере домена не выбрана DC_BRUSH кисти. Однако она не будет использоваться в операциях рисования до тех пор, пока в контроллере домена не будет выбрана DC_BRUSH запасов.

Функция GetStockObject с аргументом DC_BRUSH или DC_PEN может использоваться взаимозаменяемо с функциями SetDCPenColor и SetDCBrushColor .

ICM: Управление цветом выполняется, если включенА функция ICM.

Примеры

Пример настройки цветов см. в разделе Настройка цвета пера или кисти.

Требования

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

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

COLORREF

Функции контекста устройства

Общие сведения о контекстах устройств

GetDCBrushColor