Функция 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

См. также раздел

COLORREF

Функции контекста устройства

Общие сведения о контекстах устройств

GetDCPenColor