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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz