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

아티클
08/24/2023

PathGradientBrush::SetSurroundColors 메서드는 이 경로 그라데이션 브러시의 서라운드 색을 설정합니다. 서라운드 색은 브러시의 경계 경로에 있는 불연속 지점에 지정된 색입니다.

구문

Status SetSurroundColors(
  [in]      const Color *colors,
  [in, out] INT         *count
);

매개 변수

[in] colors

형식: const 색*

서라운드 색을 지정하는 Color 개체의 배열에 대한 포인터입니다.

[in, out] count

형식: INT*

입력 시 색 배열의 Color 개체 수를 지정하는 정수에 대한 포인터입니다. 메서드가 성공하면 출력 시 이 매개 변수는 서라운드 색 집합의 수를 받습니다. 메서드가 실패하면 이 매개 변수는 값을 받지 않습니다.

반환 값

형식: 상태

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

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

설명

경로 그라데이션 브러시에는 경계 경로와 중심점이 있습니다. 중심점은 단일 색으로 설정되지만 경계의 여러 점에 대해 서로 다른 색을 지정할 수 있습니다. 예를 들어 가운데 색에 빨간색을 지정하고 경계의 고유 지점에 파란색, 녹색 및 노란색을 지정한다고 가정합니다. 그런 다음 경계를 따라 이동하면 색이 파란색에서 녹색으로, 노란색으로, 다시 파란색으로 변경됩니다. 경계의 모든 지점에서 가운데 지점으로 직선을 따라 이동하면 해당 경계점의 색에서 빨간색으로 색이 변경됩니다.

예제

다음 예제에서는 삼각형 경로를 정의하는 3개의 점 배열을 기반으로 PathGradientBrush 개체를 만듭니다. 또한 이 코드는 세 개의 Color 개체 배열을 초기화합니다. PathGradientBrush::SetSurroundColors 메서드에 대한 호출은 색 배열의 각 색을 점 배열의 해당(동일한 인덱스) 지점과 연결합니다. 경로 그라데이션 브러시의 서라운드 색이 설정된 후 Graphics::FillRectangle 메서드는 경로 그라데이션 브러시를 사용하여 삼각형 경로를 포함하는 사각형을 그립니다.

렌더링된 삼각형의 한 가장자리가 빨간색에서 녹색으로 점진적으로 변경됩니다. 다음 가장자리는 녹색에서 검은색으로 점진적으로 변경되고 세 번째 가장자리는 검은색에서 빨간색으로 점진적으로 변경됩니다. 코드는 가운데 색을 설정하지 않으므로 가운데 색의 기본값은 검정입니다. 경계 경로(삼각형)의 모든 지점에서 가운데 지점으로 직선을 따라 이동하면 해당 경계점의 색에서 검은색으로 색이 점진적으로 변경됩니다.

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

   Point pts[] = {
      Point(20, 20), 
      Point(100, 20), 
      Point(100, 100)};

   Color cols[] = {
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 255, 0),  // green
      Color(255, 0, 0, 0)};   // black

   INT count = 3;
   PathGradientBrush pthGrBrush(pts, 3);
   pthGrBrush.SetSurroundColors(cols, &count);
   
   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);
}

요구 사항


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