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 |