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

LinearGradientBrush::GetInterpolationColors メソッドは、この線形グラデーション ブラシとそれに対応するブレンド位置に対して補間されるように現在設定されている色を取得します。

構文

Status GetInterpolationColors(
  [out] Color *presetColors,
  [out] REAL  *blendPositions,
  [in]  INT   count
);

パラメーター

[out] presetColors

種類: 色*

色を受け取る配列へのポインター。 presetColors 配列内の特定のインデックスの色は、blendPositions 配列内の同じインデックスのブレンド位置に対応します。

[out] blendPositions

種類: REAL*

ブレンド位置を受け取る配列へのポインター。 配列内の各数値は、開始境界と終了境界の間の距離の割合を示し、0.0 から 1.0 までの範囲です。0.0 はグラデーションの開始境界を示し、1.0 は終了境界を示します。 0.0 から 1.0 の間のブレンド位置は、境界線と平行な線を示します。これは、開始境界から終了境界までの距離の一定の割合です。 たとえば、ブレンド位置 0.7 は、開始境界から終了境界までの距離の 70% の線を示します。 境界線に平行な線の色は一定です。

[in] count

型: INT

presetColors 配列内の要素の数を指定する整数。 これは blendPositions 配列内の要素の数と同じです。 LinearGradientBrush オブジェクトの LinearGradientBrush::GetInterpolationColors メソッドを呼び出す前に、同じ LinearGradientBrush オブジェクトの LinearGradientBrush::GetInterpolationColorCount メソッドを呼び出して、現在の色数を決定します。 取得されるブレンド位置の数は、取得した色の数と同じです。

戻り値

種類: 状態

メソッドが成功した場合は、 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::GetInterpolationColorCount

LinearGradientBrush::SetInterpolationColors

PathGradientBrush

Rect

Solidbrush