GraphicsPath::GetBounds(Rect*,constMatrix*,constPen*) 메서드(gdipluspath.h)

GraphicsPath::GetBounds 메서드는 이 경로에 대한 경계 사각형을 가져옵니다.

구문

Status GetBounds(
  [out] Rect         *bounds,
  [in]  const Matrix *matrix,
  [in]  const Pen    *pen
);

매개 변수

[out] bounds

형식: Rect*

경계 사각형을 수신하는 Rect 개체에 대한 포인터입니다.

[in] matrix

형식: const Matrix*

(선택 사항) 경계 사각형이 계산되기 전에 이 경로에 적용할 변환을 지정하는 Matrix 개체에 대한 포인터입니다. 이 경로는 영구적으로 변환되는 것이 아니며, 경계 사각형을 계산하는 동안에만 이 경로에 변환이 사용됩니다. 기본값은 NULL입니다.

[in] pen

형식: const 펜*

(선택 사항) 경계 사각형의 크기에 영향을 주는 Pen 개체에 대한 포인터입니다. 경로가 이 매개 변수로 지정된 펜으로 그려질 때 경계 로 수신된 경계 사각형이 이 경로를 묶을 수 있을 만큼 커집니다. 이렇게 하면 경로가 넓은 펜으로 그려지더라도 경계 사각형으로 경로가 묶이게 됩니다. 기본값은 NULL입니다.

반환 값

형식: 상태

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

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

설명

이 메서드에서 반환된 사각형은 지정된 펜으로 그린 경로를 묶는 데 필요한 것보다 클 수 있습니다. 사각형은 날카로운 모서리에서 펜의 마이터 제한을 허용하고 펜의 끝 캡을 허용하도록 계산됩니다.

예제

다음 예제에서는 곡선 하나와 줄임표를 포함하는 경로를 만듭니다. 코드는 두꺼운 노란색 펜과 얇은 검은 색 펜으로 경로를 그립니다. GraphicsPath::GetBounds 메서드는 두꺼운 노란색 펜의 주소를 수신하고 경로에 대한 경계 사각형을 계산합니다. 그런 다음, 코드는 경계 사각형을 그립니다.

VOID GetBoundsExample(HDC hdc)
{
   Graphics graphics(hdc);
   Pen blackPen(Color(255, 0, 0, 0), 1);
   Pen yellowPen(Color(255, 255, 255, 0), 10);
   Pen redPen(Color(255, 255, 0, 0), 1);

   Point pts[] = {Point(120,120), 
                  Point(200,130), 
                  Point(150,200), 
                  Point(130,180)};

   // Create a path that has one curve and one ellipse.
   GraphicsPath path;
   path.AddClosedCurve(pts, 4);
   path.AddEllipse(120, 220, 100, 40);

   // Draw the path with a thick yellow pen and a thin black pen.
   graphics.DrawPath(&yellowPen, &path);
   graphics.DrawPath(&blackPen, &path);
 
   // Get the path's bounding rectangle.
   Rect rect;
   path.GetBounds(&rect, NULL, &yellowPen);
   graphics.DrawRectangle(&redPen, rect);  
}

Color(255, 0, 0, 0)Color(255, 255, 0,  0)

요구 사항

참고 항목

지역을 사용하여 클리핑

경로 구성 및 그리기

경로 그라데이션 만들기

Graphicspath

행렬

경로

펜

Rect