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

아티클
08/24/2023

Pen::SetDashPattern 메서드는 이 Pen 개체에 대한 사용자 지정 대시 및 공백 배열을 설정합니다.

구문

Status SetDashPattern(
  [in] const REAL *dashArray,
  [in] INT        count
);

매개 변수

[in] dashArray

형식: const REAL*

사용자 지정 대시 및 공백의 길이를 지정하는 실수 배열에 대한 포인터입니다. 배열의 모든 요소는 양의 실수여야 합니다.

[in] count

형식: INT

dashArray 배열의 요소 수를 지정하는 정수입니다. 정수는 0보다 크고 배열의 총 요소 수보다 크지 않아야 합니다.

반환 값

형식: 상태

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

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

설명

이 메서드는 이 Pen 개체의 DashStyle 열거형을 DashStyleCustom으로 설정합니다.

dashArray 배열의 요소는 대시 패턴에서 각 대시 및 공간의 길이를 설정합니다. 첫 번째 요소는 대시의 길이를 설정하고, 두 번째 요소는 공백의 길이를 설정하고, 세 번째 요소는 대시의 길이를 설정하는 등입니다.

대시 패턴의 각 대시 및 공간 길이는 배열의 요소 값과 Pen 개체의 너비에 대한 곱입니다.

예제

다음 예제에서는 실수 배열을 만듭니다. 그런 다음, 코드는 Pen 개체를 만들고 배열을 기반으로 대시 패턴을 설정한 다음 사용자 지정 파선선을 그립니다.

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

   // Create and set an array of real numbers.
   REAL dashVals[4] = {
      5.0f,   // dash length 5
      2.0f,   // space length 2
      15.0f,  // dash length 15
      4.0f};  // space length 4

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

   // Set the dash pattern for the custom dashed line.
   pen.SetDashPattern(dashVals, 4);

   // Draw the custom dashed line.
   graphics.DrawLine(&pen, 5, 20, 405, 200); 
}

요구 사항


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