LinearGradientBrush::LinearGradientBrush(constRect&,constColor&,constColor&,LinearGradientMode) 메서드(gdiplusbrush.h)

아티클
01/10/2024

직사각형 및 방향 모드를 기반으로 LinearGradientBrush::LinearGradientBrush 개체를 만듭니다.

구문

void LinearGradientBrush(
  [in, ref] const Rect &       rect,
  [in, ref] const Color &      color1,
  [in, ref] const Color &      color2,
  [in]      LinearGradientMode mode
);

매개 변수

[in, ref] rect

형식: const Rect

그라데이션의 시작점과 끝점을 지정하는 사각형에 대한 참조입니다. 모드로 지정된 그라데이션의 방향은 이러한 점이 정의되는 방식에 영향을 줍니다. 사각형의 차원은 정방향 대각선 모드 및 뒤로 대각선 모드의 그라데이션 방향에 영향을 줍니다.

[in, ref] color1

형식: const 색

이 선형 그라데이션 브러시의 시작 경계선에서 색을 지정하는 Color 개체에 대한 참조입니다.

[in, ref] color2

형식: const 색

이 선형 그라데이션 브러시의 끝 경계선에서 색을 지정하는 Color 개체에 대한 참조입니다.

[in] mode

형식: LinearGradientMode

그라데이션의 방향을 지정하는 LinearGradientMode 열거형의 요소입니다.

반환 값

없음

설명

그라데이션의 시작 경계는 시작점을 통과하거나 사각형 사각형의 테두리를 지정하는 직선입니다. 그라데이션의 끝 경계는 시작 경계선과 평행하고 끝점을 통과하거나 사각형에 테두리를 지정하는 직선입니다. 가상의 직선인 "방향선"은 경계선에 수직입니다. 그라데이션 색은 경계선과 평행한 선을 따라 일정합니다. 그라데이션은 방향선을 따라 시작 색에서 끝 색으로 점차 변경됩니다.

모드는 그라데이션의 경계에 영향을 줍니다.

세로 모드 경계선은 사각형 사각형의 위쪽(및 아래쪽)과 평행합니다. 시작 및 끝 경계선은 각각 사각형 사각형의 위쪽과 아래쪽입니다.
가로 모드 경계선은 사각형 사각형의 왼쪽(및 오른쪽)과 평행 합니다. 시작 및 끝 경계선은 각각 사각형 사각형의 왼쪽과 오른쪽 입니다.
정방향 대각선 모드 경계선은 사각형 사각형의 오른쪽 위 모서리와 왼쪽 아래 모서리로 정의된 대각선과 평행합니다. 시작 경계선은 시작점(사각형 사각형의 왼쪽 위 모서리)을 통과합니다. 끝 경계선은 끝점(사각형 사각형의 오른쪽 아래 모서리)을 통과합니다. 시작점과 끝점은 뒤로 대각선 모드의 시작점과 끝점의 반대입니다.
뒤로 대각선 모드 경계선은 사각형 사각형의 왼쪽 위 모서리와 오른쪽 아래 모서리로 정의된 대각선과 평행합니다. 시작 경계선은 시작점(사각형 사각형의 오른쪽 위 모서리)을 통과합니다. 끝 경계선은 끝점(사각형 사각형의 왼쪽 아래 모서리)을 통과합니다. 시작점과 끝점은 앞으로 대각선 모드의 시작점과 끝점의 반대입니다.

예제

다음 예제에서는 모드 설정에 LinearGradientModeVertical을 사용하여 선형 그라데이션 브러시를 만듭니다.

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

   LinearGradientBrush linGrBrush(
      Rect(20, 10, 200, 100),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255),   // blue
      LinearGradientModeVertical);
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 300, 300); 
}

요구 사항

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