LinearGradientBrush::GetRectangle(Rect*) 메서드(gdiplusbrush.h)

아티클
08/23/2023

LinearGradientBrush::GetRectangle 메서드는 그라데이션의 경계를 정의하는 사각형을 가져옵니다.

구문

Status GetRectangle(
  [out] Rect *rect
);

매개 변수

[out] rect

형식: Rect*

그라데이션의 경계를 정의하는 사각형을 수신하는 Rect 개체에 대한 포인터입니다. 예를 들어 선형 그라데이션 브러시가 시작점(20, 50)과 끝점(60, 110)으로 구성된 경우 정의 사각형의 왼쪽 위 점(20, 50), 너비 40, 높이 60이 있습니다.

반환 값

형식: 상태

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

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

설명

사각형은 다음과 같은 방법으로 그라데이션의 경계를 정의합니다. 사각형의 오른쪽과 왼쪽은 가로 그라데이션의 경계를 형성합니다. 위쪽과 아래쪽은 세로 그라데이션의 경계를 형성합니다. 대각선으로 반대되는 두 모서리는 대각선 그라데이션의 경계에 있습니다. 이러한 각 경우에서 시작 지점과 끝점이 생성자에 전달되는 방법에 따라 양쪽/모서리가 시작 경계에 있을 수 있습니다.

예제

다음 예제에서는 선형 그라데이션 브러시를 만듭니다. 그런 다음 코드는 브러시의 사각형을 가져오고 그립니다.

VOID Example_GetRect(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Create a linear gradient brush.
   LinearGradientBrush linGrBrush( 
      Point(20, 10),
      Point(60, 110),
      Color(255, 0, 0, 0),     // black
      Color(255, 0, 0, 255));  // blue

   // Obtain information about the linear gradient brush.
   Rect rect;
   linGrBrush.GetRectangle(&rect);

   // Draw the retrieved rectangle.
   Pen myPen(Color(255, 0, 0, 0));
   myGraphics.DrawRectangle(&myPen, rect);
}

요구 사항


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