PathGradientBrush::GetRectangle(RectF*) メソッド (gdipluspath.h)

[アーティクル]
03/05/2024

PathGradientBrush::GetRectangle メソッドは、このパスグラデーションブラシの境界パスを囲む最小の四角形を取得します。

構文

Status GetRectangle(
  RectF *rect
);

パラメーター

rect

外接する四角形を受け取る RectF オブジェクトへのポインター。

戻り値

Type:Status

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

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

解説

例

次の例では、4 つのポイントで定義された多角形に基づいて PathGradientBrush オブジェクトを作成します。このコードは、 PathGradientBrush オブジェクトの PathGradientBrush::GetRectangle メソッドを呼び出して、ブラシの境界パスを囲む最小の四角形を取得します。このコードは Graphics オブジェクトの Graphics::FillRectangle メソッドを呼び出し、 PathGradientBrush オブジェクトのアドレスとブラシの外接する四角形への参照を渡します。この呼び出しは、ブラシの境界パス内にある外接する四角形の部分のみを塗りつぶします。最後に、外接する四角形のアウトラインを描画します。

VOID Example_GetRect(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 0));

   // Create a path gradient brush based on an array of points.
   Point points[] = {
      Point(30, 20),
      Point(150, 40),
      Point(100, 100),
      Point(60, 200) };

   PathGradientBrush pthGrBrush(points, 4);

   // Obtain information about the path gradient brush.
   RectF rect;
   pthGrBrush.GetRectangle(&rect);

   graphics.FillRectangle(&pthGrBrush, rect);
   graphics.DrawRectangle(&pen, rect);
}