PathGradientBrush::SetFocusScales メソッド (gdipluspath.h)

[アーティクル]
08/24/2023

PathGradientBrush::SetFocusScales メソッドは、このパスグラデーションブラシのフォーカススケールを設定します。

構文

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

パラメーター

[in] xScale

種類: REAL

x フォーカススケールを指定する実数。

[in] yScale

種類: REAL

y フォーカススケールを指定する実数。

戻り値

種類: 状態

メソッドが成功した場合は、Status 列挙体の要素である Ok を返します。

メソッドが失敗した場合は、 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 を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll