Функция SetDCPenColor

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

Назад в оглавление

На главную страницу

На оглавление справки