PathGradientBrush::SetInterpolationColors 메서드(gdipluspath.h)

아티클
02/26/2024

PathGradientBrush::SetInterpolationColors 메서드는 이 경로 그라데이션 브러시의 미리 설정된 색과 혼합 위치를 설정합니다.

구문

Status SetInterpolationColors(
  [in] const Color *presetColors,
  [in] const REAL  *blendPositions,
  [in] INT         count
);

매개 변수

[in] presetColors

형식: const 색*

그라데이션의 보간 색을 지정하는 Color 개체의 배열에 대한 포인터입니다. presetColors 배열의 지정된 인덱스 색은 blendPositions 배열에서 동일한 인덱스의 혼합 위치에 해당합니다.

[in] blendPositions

형식: REAL*

혼합 위치를 지정하는 배열에 대한 포인터입니다. 각 혼합 위치는 0에서 1까지의 숫자입니다. 여기서 0은 그라데이션의 경계를 나타내고 1은 중심점을 나타냅니다. 0에서 1 사이의 혼합 위치는 경계에서 중심점까지의 거리의 특정 부분인 모든 점 집합을 지정합니다. 예를 들어 혼합 위치 0.7은 경계에서 중심점까지의 70%인 모든 점 집합을 지정합니다.

[in] count

형식: INT

presetColors 배열의 Color 개체 수를 지정하는 정수입니다. blendPositions 배열의 요소 수와 동일합니다.

반환 값

형식: 상태

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

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

설명

단순 경로 그라데이션 브러시에는 경계 색과 가운데 색의 두 가지 색이 있습니다. 이러한 브러시로 칠하면 경계 경로에서 가운데 지점으로 이동할 때 색이 경계 색에서 가운데 색으로 점진적으로 변경됩니다. 미리 설정된 색 배열과 혼합 위치 배열을 지정하여 보다 복잡한 그라데이션을 만들 수 있습니다.

예제

다음 예제에서는 삼각형 경로를 기반으로 PathGradientBrush 개체를 만듭니다. PathGradientBrush::SetInterpolationColors 메서드는 브러시의 미리 설정된 색을 빨간색, 파란색 및 아쿠아로 설정하고 혼합 위치를 0, 0, 4 및 1로 설정합니다. Graphics::FillRectangle 메서드는 경로 그라데이션 브러시를 사용하여 삼각형 경로가 포함된 사각형을 그립니다.

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

   Point points[] = {Point(100, 0), Point(200, 200), Point(0, 200)};
   PathGradientBrush pthGrBrush(points, 3);

   Color col[] = {
      Color(255, 255, 0, 0),     // red
      Color(255, 0, 0, 255),     // blue
      Color(255, 0, 255, 255)};  // aqua

   REAL pos[] = {
      0.0f,    // red at the boundary
      0.4f,    // blue 40 percent of the way from the boundary to the center
      1.0f};   // aqua at the center

   pthGrBrush.SetInterpolationColors(col, pos, 3);
   graphics.FillRectangle(&pthGrBrush, 0, 0, 300, 300);  
}

요구 사항

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