Функция 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 |
Нет |
|
Замечания по платформе |
Не имеется |