다음을 통해 공유


Pen::SetDashStyle 메서드(gdipluspen.h)

Pen::SetDashStyle 메서드는 이 Pen 개체의 대시 스타일을 설정합니다.

구문

Status SetDashStyle(
  [in] DashStyle dashStyle
);

매개 변수

[in] dashStyle

형식: DashStyle

Pen 개체의 대시 스타일을 지정하는 DashStyle 열거형의 요소입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 확인을 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

파선의 대시 길이는 파선 스타일과 Pen 개체의 너비에 따라 달라집니다. 파선에서 두 개의 대시를 구분하는 공간의 길이는 Pen 개체의 너비와 같습니다.

예제

다음 예제에서는 Pen 개체를 만들고 대시 스타일을 설정하고 선을 그립니다. 그런 다음, 코드는 대시 스타일을 재설정하고, 두 번째 선을 그리고, 대시 스타일을 다시 설정하며, 세 번째 선을 그립니다.

VOID Example_SetDashStyle(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Pen object.
   Pen pen(Color(255, 0, 0, 255), 15);

   // Set the dash style for the pen, and draw a dashed line.
   pen.SetDashStyle(DashStyleDash);
   graphics.DrawLine(&pen, 0, 50, 400, 150);

   // Reset the dash style for the pen, and draw a second line.
   pen.SetDashStyle(DashStyleDot);
   graphics.DrawLine(&pen, 0, 80, 400, 180); 

   // Reset the dash style for the pen, and draw a third line.
   pen.SetDashStyle(DashStyleDashDot);
   graphics.DrawLine(&pen, 0, 110, 400, 210); 
}

요구 사항

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

추가 정보

사용자 지정 파선 그리기

펜::GetDashCap

펜::GetDashOffset

펜::GetDashPattern

펜::GetDashPatternCount

펜::GetDashStyle

펜::SetDashCap

펜::SetDashOffset

펜::SetDashPattern

펜, 선 및 사각형