Функция SetDCPenColor (wingdi.h)
Функция SetDCPenColor задает для текущего цвета пера контекста устройства (DC) указанное значение цвета. Если устройство не может представить указанное значение цвета, для цвета устанавливается ближайший физический цвет.
Синтаксис
COLORREF SetDCPenColor(
[in] HDC hdc,
[in] COLORREF color
);
Параметры
[in] hdc
Дескриптор контроллера домена.
[in] color
Новый цвет пера.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение задает предыдущий цвет пера DC в качестве значения COLORREF . Если функция выполняется неудачно, возвращается значение CLR_INVALID.
Комментарии
Функция возвращает предыдущий цвет DC_PEN, даже если DC_PEN пера не выбрано в контроллере домена; однако он не будет использоваться в операциях рисования до тех пор, пока в контроллере домена не будет выбрана DC_PEN запасов.
Функция 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 |