LinearGradientBrush::LinearGradientBrush(constRect&,constColor&,constColor&,REAL,BOOL) メソッド (gdiplusbrush.h)

四角形と方向の角度から LinearGradientBrush::LinearGradientBrush オブジェクトを作成します。

構文

void LinearGradientBrush(
  [in, ref] const Rect &  rect,
  [in, ref] const Color & color1,
  [in, ref] const Color & color2,
  [in]      REAL          angle,
  [in]      BOOL          isAngleScalable
);

パラメーター

[in, ref] rect

型: const Rect

グラデーションの始点と終点を指定する四角形への参照。 四角形の左上隅が開始点です。 右下隅は終了点です。

[in, ref] color1

種類: const Color

この線形グラデーション ブラシの開始境界線の色を指定する Color オブジェクトへの参照。

[in, ref] color2

種類: const Color

この線形グラデーション ブラシの終了境界線の色を指定する Color オブジェクトへの参照。

[in] angle

種類: REAL

isAngleScalable が TRUE の場合、方向線の角度を計算する基準角度を指定する実数。isAngleScalable が FALSE の場合は方向線の角度を指定します。 角度は、 rect で指定された四角形の上部から測定され、角度で指定する必要があります。 グラデーションは方向線に従います。

[in] isAngleScalable

種類: BOOL

角度がスケーラブルかどうかを指定するブール値。 isAngleScalable が TRUE の場合、方向線の角度はスケーラブルです。それ以外の場合、角度はスケーラブルではありません。

戻り値

なし

解説

仮想直線である "方向線" は、始点 (四角形 の矩形の左上隅) と 角度の角度によって定義されます。 グラデーションの開始境界は、方向線に対して垂直で、始点を通過する直線です。 グラデーションの終了境界は、開始境界線と平行で、終了点 (四角形 の右下隅) を通過する直線です。 グラデーションの色は、境界線に平行な線に沿って一定です。 グラデーションは、開始色から方向線に沿って終了色に徐々に変化します。

isAngleScalable が TRUE の場合、基本角度がスケーリングされ、方向線の角度が生成されます。

ß = arctan( (width / height) tan(ø) )

ここで、ß は方向線の新しい角度です。width と height は四角形のサイズです。と ø はベース角度 です。 このリレーションシップは、角度が 90 度未満の場合にのみ有効です。

要件

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

こちらもご覧ください

LinearGradientBrush