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

아티클
08/24/2023

PathGradientBrush::SetBlendBellShape 메서드는 이 경로 그라데이션 브러시의 혼합 모양을 설정합니다.

구문

Status SetBlendBellShape(
  [in]           REAL focus,
  [in, optional] REAL scale
);

매개 변수

[in] focus

형식: REAL

가운데 색이 가장 높은 강도의 위치를 지정하는 실수입니다. 이 숫자는 0부터 1까지의 범위에 있어야 합니다.

[in, optional] scale

형식: REAL

선택 사항입니다. 경계 색과 혼합되는 가운데 색의 최대 강도를 지정하는 실수입니다. 이 숫자는 0부터 1까지의 범위에 있어야 합니다. 기본값은 1입니다.

반환 값

형식: 상태

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

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

설명

기본적으로 경로 그라데이션의 경계에서 가운데 지점으로 이동하면 경계 색에서 가운데 색으로 색이 점차 변경됩니다. PathGradientBrush::SetBlendBellShape 메서드를 호출하여 경계 및 가운데 색의 위치 지정 및 혼합을 사용자 지정할 수 있습니다.

예제

다음 예제에서는 타원을 기반으로 PathGradientBrush 개체를 만듭니다. 이 코드는 PathGradientBrush 개체의 PathGradientBrush::SetBlendBellShape 메서드를 호출하여 포커스가 0.2이고 배율 0.7을 전달합니다. 그런 다음, 코드는 경로 그라데이션 브러시를 사용하여 타원을 포함하는 사각형을 그립니다.

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

   // Create a path that consists of a single ellipse.
   GraphicsPath path;
   path.AddEllipse(0, 0, 200, 100);

   // Use the path to construct a brush.
   PathGradientBrush pthGrBrush(&path);

   // Set the color at the center of the path to red.
   pthGrBrush.SetCenterColor(Color(255, 255, 0, 0));

   // Set the color along the entire boundary of the path to blue.
   Color colors[] = {Color(255, 0, 0, 255)};
   INT count = 1;
   pthGrBrush.SetSurroundColors(colors, &count);

   pthGrBrush.SetBlendBellShape(0.2f, 0.7f);

   // The color is blue on the boundary and at the center.
   // At points that are 20 percent of the way from the boundary to the
   // center, the color is 70 percent red and 30 percent blue.

   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