LinearGradientBrush::SetInterpolationColors メソッド (gdiplusbrush.h)

  • [アーティクル]

LinearGradientBrush::SetInterpolationColors メソッドは、この線形グラデーション ブラシとそれに対応するブレンド位置に補間する色を設定します。

構文

Status SetInterpolationColors(
  [in] const Color *presetColors,
  [in] const REAL  *blendPositions,
  [in] INT         count
);

パラメーター

[in] presetColors

種類: const Color*

この線形グラデーション ブラシの補間する色を指定する Color オブジェクトの配列へのポインター。 presetColors 配列内の特定のインデックスの色は、blendPositions 配列内の同じインデックスのブレンド位置に対応します。

[in] blendPositions

型: const REAL*

ブレンド位置を指定する実数の配列へのポインター。 配列内の各数値は、開始境界と終了境界の間の距離の割合を指定し、0.0 から 1.0 までの範囲です。0.0 はグラデーションの開始境界を示し、1.0 は終了境界を示します。 少なくとも 2 つの位置が指定されている必要があります。最初の位置は常に 0.0f、最後の位置は常に 1.0f です。 それ以外の場合、動作は未定義です。 0.0 から 1.0 の間のブレンド位置は、境界線と平行な線を示します。これは、開始境界から終了境界までの距離の一定の割合です。 たとえば、ブレンド位置 0.7 は、開始境界から終了境界までの距離の 70% の線を示します。 境界線に平行な線の色は一定です。

[in] count

型: INT

presetColors 配列内の要素の数を指定する整数。 これは blendPositions 配列内の要素の数と同じです。

戻り値

種類: 状態

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

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

要件

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

こちらもご覧ください

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

Color

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

色のグラデーションで図形を塗りつぶす

LinearGradientBrush

LinearGradientBrush::GetInterpolationColors