LinearGradientBrush::GetBlend 메서드(gdiplusbrush.h)

아티클
08/23/2023

LinearGradientBrush::GetBlend 메서드는 LinearGradientBrush 개체에서 혼합 요소와 해당 혼합 위치를 가져옵니다.

구문

Status GetBlend(
  [out] REAL *blendFactors,
  [out] REAL *blendPositions,
  [in]  INT  count
);

매개 변수

[out] blendFactors

형식: REAL*

혼합 요소를 수신하는 배열에 대한 포인터입니다. 배열의 각 숫자는 끝 색의 백분율을 나타내며 0.0에서 1.0까지의 범위에 있습니다.

[out] blendPositions

형식: REAL*

혼합 위치를 받는 배열에 대한 포인터입니다. 배열의 각 숫자는 시작 경계와 끝 경계 사이의 거리 백분율을 나타내며 0.0에서 1.0 사이의 범위에 있습니다. 여기서 0.0은 그라데이션의 시작 경계를 나타내고 1.0은 끝 경계를 나타냅니다. 0.0에서 1.0 사이의 혼합 위치는 경계선과 평행한 선을 나타내며, 이는 시작 경계에서 끝 경계까지의 거리의 특정 부분입니다. 예를 들어 혼합 위치 0.7은 시작 경계에서 끝 경계까지의 거리의 70%인 선을 나타냅니다. 색은 경계선과 평행한 선에서 상수입니다.

[in] count

형식: INT

검색할 혼합 요소 수를 지정하는 정수입니다. LinearGradientBrush 개체의 LinearGradientBrush::GetBlend 메서드를 호출하기 전에 동일한 LinearGradientBrush 개체의 LinearGradientBrush::GetBlendCount 메서드를 호출하여 현재 혼합 요소 수를 확인합니다. 검색된 혼합 위치의 수는 검색된 혼합 요소 수와 동일합니다.

반환 값

형식: 상태

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

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

설명

LinearGradientBrush 개체에는 시작 경계와 끝 경계라는 두 개의 병렬 경계가 있습니다. 색은 이러한 두 경계 각각과 연결됩니다. 각 경계는 지정된 지점을 통과하는 직선입니다. 시작 경계는 시작점을 통과합니다. 끝 경계는 끝점을 통과하며 선형 그라데이션 브러시의 방향에 수직입니다. 선형 그라데이션 브러시의 방향은 시작점과 끝점으로 정의된 선을 따릅니다. 이 선인 "방향선"은 가로, 세로 또는 대각선일 수 있습니다. 경계와 평행한 선에 있는 모든 점이 동일한 색입니다. 선형 그라데이션 브러시로 영역을 채우면 시작 경계에서 끝 경계로 방향선을 따라 이동하면서 색이 한 줄에서 다음 줄로 점진적으로 변경됩니다. 기본적으로 색 변경은 거리 변경에 비례합니다. 즉, 시작 경계와 끝 경계 사이의 거리의 30%에 있는 선은 시작 경계 색과 끝 경계 색 사이의 거리의 30%인 색을 가집니다. 색 패턴은 시작 및 끝 경계 외부에서 반복됩니다.

LinearGradientBrush 개체의 LinearGradientBrush::SetBlend 메서드를 호출하여 색과 거리 간의 관계를 사용자 지정할 수 있습니다. 예를 들어 혼합 위치를 {0, 0.5, 1}로 설정하고 혼합 요소를 {0, 0.3, 1}로 설정한다고 가정합니다. 그런 다음 시작 경계와 끝 경계 사이의 거리의 50%에 있는 선은 시작 경계 색과 끝 경계 색 사이의 거리의 30%인 색을 갖습니다.

예제

다음 예제에서는 선형 그라데이션 브러시를 만들고, 혼합을 설정하고, 브러시를 사용하여 사각형을 채웁니다. 그런 다음 코드는 혼합을 가져옵니다. 그런 다음 혼합 요소와 위치를 검사하거나 어떤 식으로든 사용할 수 있습니다.

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

   // Create a linear gradient brush, and set its blend.
   REAL fac[] = {0.0f, 0.4f, 0.6f, 1.0f};
   REAL pos[] = {0.0f, 0.2f, 0.8f, 1.0f};

   LinearGradientBrush linGrBrush(
      Point(0, 0), 
      Point(100, 0),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   linGrBrush.SetBlend(fac, pos, 4);

   // Use the linear gradient brush to fill a rectangle.
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 100, 50);

   // Obtain information about the linear gradient brush.
   INT   blendCount;
   REAL* factors = NULL;
   REAL* positions = NULL;

   blendCount = linGrBrush.GetBlendCount();
   factors = new REAL[blendCount];
   positions = new REAL[blendCount];

   linGrBrush.GetBlend(factors, positions, blendCount);

   for(INT j = 0; j < blendCount; ++j)
   {
      // Inspect or use the value in factors[j].
      // Inspect or use the value in positions[j].
   }
}

요구 사항


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