LinearGradientBrush::LinearGradientBrush(constRectF&,constColor&,constColor&,LinearGradientMode) メソッド (gdiplusbrush.h)

[アーティクル]
01/10/2024

四角形と方向モードに基づいて LinearGradientBrush::LinearGradientBrush オブジェクトを作成します。

構文

void LinearGradientBrush(
  [in, ref] const RectF &      rect,
  [in, ref] const Color &      color1,
  [in, ref] const Color &      color2,
  [in]      LinearGradientMode mode
);

パラメーター

[in, ref] rect

型: const RectF

グラデーションの始点と終点を指定する四角形への参照。 モードで指定されたグラデーションの方向は、これらのポイントの定義方法に影響します。四角形の寸法は、前方斜めモードと逆方向斜めモードのグラデーションの方向に影響します。

[in, ref] color1

型: const Color

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

[in, ref] color2

型: const Color

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

[in] mode

種類: LinearGradientMode

グラデーションの方向を指定する LinearGradientMode 列挙体の要素。

戻り値

なし

解説

グラデーションの開始境界は、始点を通過 するか、四角形の四角形の境界線を通過する直線です。グラデーションの終了境界は、開始境界線と平行な直線であり、終了点を通過するか、四角形に罫線を配置します。仮想直線である "方向線" は、境界線に対して垂直です。グラデーションの色は、境界線に平行な線に沿って一定です。グラデーションは、開始色から方向線に沿って終了色に徐々に変化します。

モードは、グラデーションの境界に影響します。

垂直モード境界線 は、四角形の上 (下) と平行です。開始境界線と終了境界線は、それぞれ四角形の上と下の境界線です。
水平モード境界線 は、四角形の左 (および右) に平行です。開始境界線と終了境界線はそれぞれ、四角形の右と左の境界線です。
前方斜めモード境界線は 、四角形の右上隅と左下隅で定義される対角線と平行です。開始境界線は、開始点 (四角形の四角形の左上隅) を通過します。終了境界線は、終了点 (四角形の右下隅) を通過します。始点と終点は、逆方向斜めモードの始点と終点の反対側であることに注意してください。
後方斜めモード境界線は 、四角形の左上隅と右下隅で定義される対角線と平行です。開始境界線は、開始点 (四角形の四角形の右上隅) を通過します。終了境界線は、終了点 (四角形の四角形の左下隅) を通過します。始点と終点は、前方斜めモードの開始点と終了点の反対側であることに注意してください。

要件


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