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

아티클
03/05/2024

PathGradientBrush::SetFocusScales 메서드는 이 경로 그라데이션 브러시의 포커스 배율을 설정합니다.

구문

Status SetFocusScales(
  [in] REAL xScale,
  [in] REAL yScale
);

매개 변수

[in] xScale

형식: REAL

x 포커스 배율을 지정하는 실수입니다.

[in] yScale

형식: REAL

y 포커스 배율을 지정하는 실수입니다.

반환 값

형식: 상태

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

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

설명

기본적으로 경로 그라데이션의 가운데 색은 중심점에 있습니다. PathGradientBrush::SetFocusScales를 호출하여 중심점을 둘러싸는 경로를 따라 가운데 색을 표시하도록 지정할 수 있습니다. 이 경로는 x 방향의 xScale 요소와 y 방향의 yScale 요소로 크기가 조정된 경계 경로입니다. 크기 조정된 경로 내의 영역은 가운데 색으로 채워집니다.

예제

다음 예제에서는 삼각형 경로를 기반으로 PathGradientBrush 개체를 만듭니다. 이 코드는 PathGradientBrush 개체의 PathGradientBrush::SetFocusScales 메서드를 호출하여 브러시의 포커스 배율을 (0.2, 0.2)로 설정합니다. 그런 다음, 코드는 경로 그라데이션 브러시를 사용하여 삼각형 경로를 포함하는 사각형을 그립니다.

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

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

   // No GraphicsPath object is created. The PathGradientBrush
   // object is constructed directly from the array of points.
   PathGradientBrush pthGrBrush(points, 3);

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

   REAL relativePositions[] = {
      0.0f,    // red at the boundary of the outer triangle
      1.0f};   // blue at the boundary of the inner triangle

   pthGrBrush.SetInterpolationColors(colors, relativePositions, 2);

   // The inner triangle is formed by scaling the outer triangle
   // about its centroid. The scaling factor is 0.2 in both
   // the x and y directions.
   pthGrBrush.SetFocusScales(0.2f, 0.2f);

   // Fill a rectangle that is larger than the triangle
   // specified in the Point array. The portion of the
   // rectangle outside the triangle will not be painted.
   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