Функция SetDCPenColor устанавливает цвет пера в текущем контексте устройства (DC) в заданный код цвета. Если устройство не может представить устанавливаемый код цвета, цвет устанавливается в самый близкий реальный цвет.
Синтаксис
COLORREF SetDCPenColor( HDC hdc, // дескриптор контекста устройства (DC) COLORREF crColor // новый цвет пера ); |
Параметры
hdc
[in] Дескриптор контекста устройства (DC).crColor
[in] Устанавливает новый цвет пера.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение определяет предыдущий цвет пера контекста устройства (DC) как значение COLORREF. Если функция завершается ошибкой, возвращаемое значение - CLR_INVALID.
Замечания
Функция возвращает предыдущий цвет DC_PEN, даже если предопределенное перо DC_PEN не выбрано в контексте устройства (DC); однако, оно не будет использовано в операциях рисования до тех пор, пока предопределение DC_PEN не будет выбрано в контексте устройства (DC).
Функция GetStockObject с параметром DC_BRUSH или DC_PEN может быть использована взаимозаменяемо с функциями SetDCPenColor и SetDCBrushColor.
ICM: Управление цветом выполняется тогда, когда разрешается Независимое управление цветом ( ICM).
Пример установки цвета смотри в статье Установка цвета пера или кисти.
Смотри такжеОбзор Контексты устройства, Функции, используемые контекстами устройства, GetDCPenColor, COLORREF
Размещение и совместимость SetDCPenColor |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Нет |
Windows Me |
Нет |
Windows 98 |
Нет |
Windows 95 |
Нет |
Используемая библиотека |
Gdi32.lib |
Заголовочный файл |
|
- объявлено в |
Wingdi.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |