LinearGradientBrush::GetRectangle(Rect*) メソッド (gdiplusbrush.h)

LinearGradientBrush::GetRectangle メソッドは、グラデーションの境界を定義する四角形を取得します。

構文

Status GetRectangle(
  [out] Rect *rect
);

パラメーター

[out] rect

型: Rect*

グラデーションの境界を定義する四角形を受け取る Rect オブジェクトへのポインター。 たとえば、線形グラデーション ブラシが (20, 50) の開始点と終了点 (60, 110) で構成されている場合、定義する四角形の左上のポイントは (20, 50)、幅は 40、高さは 60 です。

戻り値

種類: 状態

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

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

解説

四角形は、次の方法でグラデーションの境界を定義します。四角形の右側と左側は、水平方向のグラデーションの境界を形成します。 上下の辺は、垂直方向のグラデーションの境界を形成します。 斜めに対向する 2 つのコーナーは、斜めのグラデーションの境界にあります。 これらの各ケースでは、開始点と終了点がコンストラクターに渡される方法に応じて、両側または角が開始境界上にある可能性があります。

例

次の例では、線形グラデーション ブラシを作成します。 次に、コードはブラシの四角形を取得して描画します。

VOID Example_GetRect(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Create a linear gradient brush.
   LinearGradientBrush linGrBrush( 
      Point(20, 10),
      Point(60, 110),
      Color(255, 0, 0, 0),     // black
      Color(255, 0, 0, 255));  // blue

   // Obtain information about the linear gradient brush.
   Rect rect;
   linGrBrush.GetRectangle(&rect);

   // Draw the retrieved rectangle.
   Pen myPen(Color(255, 0, 0, 0));
   myGraphics.DrawRectangle(&myPen, rect);
}

要件

サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusbrush.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll

関連項目

ブラシと図形の塗りつぶし

線形グラデーションの作成

LinearGradientBrush

ペン

ペン、直線、および四角形

Point

Rect

ペンを使用した直線と四角形の描画