SetDCPenColor 함수(wingdi.h)

SetDCPenColor 함수는 현재 DC(디바이스 컨텍스트) 펜 색을 지정된 색 값으로 설정합니다. 디바이스가 지정된 색 값을 나타낼 수 없는 경우 색은 가장 가까운 실제 색으로 설정됩니다.

구문

COLORREF SetDCPenColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

매개 변수

[in] hdc

DC에 대한 핸들입니다.

[in] color

새 펜 색입니다.

반환 값

함수가 성공하면 반환 값은 이전 DC 펜 색을 COLORREF 값으로 지정합니다. 함수가 실패하면 반환 값은 CLR_INVALID입니다.

설명

함수는 DC에서 스톡 펜 DC_PEN 선택되지 않은 경우에도 이전 DC_PEN 색을 반환합니다. 그러나 DC에서 스톡 DC_PEN 선택될 때까지 그리기 작업에는 사용되지 않습니다.

DC_BRUSH 또는 DC_PEN 인수가 있는 GetStockObject 함수는 SetDCPenColorSetDCBrushColor 함수와 교환하여 사용할 수 있습니다.

Icm: ICM을 사용하는 경우 색 관리가 수행됩니다.

예제

색을 설정하는 예제는 펜 또는 브러시 색 설정을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 wingdi.h(Windows.h 포함)
라이브러리 Gdi32.lib
DLL Gdi32.dll

추가 정보

COLORREF

디바이스 컨텍스트 함수

디바이스 컨텍스트 개요

GetDCPenColor