다음을 통해 공유


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

Pen::SetCompoundArray 메서드는 이 Pen 개체의 복합 배열을 설정합니다.

구문

Status SetCompoundArray(
  [in] const REAL *compoundArray,
  [in] INT        count
);

매개 변수

[in] compoundArray

형식: const REAL*

복합 배열을 지정하는 실수 배열에 대한 포인터입니다. 배열의 요소는 0보다 작지 않고 1보다 크지 않아야 하며 오름차순이어야 합니다.

[in] count

형식: INT

compoundArray 배열의 요소 수를 지정하는 양의 정수입니다. 정수는 복합 배열의 요소 수보다 크지 않아야 합니다.

반환 값

형식: 상태

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

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

설명

첫 번째 줄의 너비가 펜 너비의 20%이고 두 줄을 구분하는 공간의 너비가 펜 너비의 50%이고 두 번째 줄의 너비가 펜 너비의 30%인 두 개의 병렬 선을 그리려는 경우를 가정해 보겠습니다. 먼저 Pen 개체와 실수 배열을 만듭니다. 그런 다음, 값이 0.0, 0.2, 0.7 및 1.0인 배열을 Pen 개체의 Pen::SetCompoundArray 메서드에 전달하여 복합 배열을 설정할 수 있습니다.

Pen 개체의 맞춤을 PenAlignmentInset으로 설정하면 해당 펜을 사용하여 복합 선을 그릴 수 없습니다.

예제

다음 예제에서는 펜 개체를 만들고 의 복합 배열을 설정합니다. 그런 다음, 코드는 Pen 개체를 사용하여 선을 그립니다.

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

   // Create an array of real numbers and a Pen object.
   REAL compVals[6] = {0.0f, 0.2f, 0.5f, 0.7f, 0.9f, 1.0f};
   Pen pen(Color(255, 0, 0, 255), 30);

   // Set the compound array of the pen.
   pen.SetCompoundArray(compVals, 6);

   // Draw a line with the pen.
   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

참고 항목

사용자 지정 파선 그리기

펜::GetCompoundArray

펜::GetCompoundArrayCount

펜, 선 및 사각형