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

아티클
08/24/2023

Pen::GetDashPattern 메서드는 이 Pen 개체에 대해 현재 설정된 사용자 지정 대시 및 공백 배열을 가져옵니다.

구문

Status GetDashPattern(
  [out] REAL *dashArray,
  [in]  INT  count
);

매개 변수

[out] dashArray

형식: REAL*

사용자 지정 파선의 대시 및 공백 길이를 받는 배열에 대한 포인터입니다.

[in] count

형식: INT

dashArray 배열의 요소 수를 지정하는 정수입니다.

반환 값

형식: 상태

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

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

설명

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

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

예제

다음 예제에서는 실수 및 Pen 개체의 배열을 만들고, 대시 패턴을 설정하고, 사용자 지정 파선선을 그립니다. 그런 다음, 코드는 펜에 대해 현재 설정된 대시 패턴을 가져옵니다.

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

   // Create a custom dashed pen, and use it to draw a line.
   REAL dashVals[4] = {5, 2, 15, 4};
   Pen pen(Color(255, 0, 0, 0), 5);
   pen.SetDashPattern(dashVals, 4);
   graphics.DrawLine(&pen, 5, 20, 405, 200);

   // Obtain information about the pen.
   INT count = 0;
   REAL* dashValues = NULL;

   count = pen.GetDashPatternCount();
   dashValues = new REAL[count];
   pen.GetDashPattern(dashValues, count);

   for(INT j = 0; j < count; ++j)
   {
      // Inspect or use the value in dashValues[j].
   }
   delete [] dashValues;
}

요구 사항


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