Функция SetDCBrushColor

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

Синтаксис

COLORREF SetDCBrushColor(
  HDC hdc,          // дескриптор контекста устройства (DC)
  COLORREF crColor  // новый цвет кисти
);

Параметры

hdc

[in] Дескриптор контекста устройства (DC).

crColor

[in] Определяет новый цвет кисти.

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

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

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

Замечания

Когда в контексте устройства (DC) выбирается заготовка кисти DC_BRUSH, все последующие рисунки должны использовать цвет этой кисти в контексте устройства (DC) до тех пор, пока не будет отменен её выбор. По умолчанию цвет DC_BRUSH является БЕЛЫМ.

Функция возвращает значение цвета предыдущий DC_BRUSH, даже если предопределенная кисть DC_BRUSH в контексте устройства (DC) не выбрана: однако, она не будет использоваться в операциях рисования до тех пор, пока заготовка DC_BRUSH не будет выбрана в контексте устройства (DC).

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

Независимое управление цветом (ICM): Управление цветом выполняется тогда, если ICM включено.

Код примера

Пример настройки цвета смотри в статье Установка цвета пера или кисти.

Смотри также 

Обзор Контексты устройства (DC), Функции, используемые контекстами устройства,  GetDCBrushColor, COLORREF

Размещение и совместимость SetDCBrushColor

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Нет

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

Используемая библиотека

Gdi32.lib

Заголовочный файл

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz