ID2D1GradientStopCollection

線形および放射状のグラデーションブラシで使用する D2D1_GRADIENT_STOP オブジェクトのコレクションを表します。

ID2D1GradientStopCollection オブジェクトの作成

グラデーションストップコレクションはデバイス依存のリソースです。アプリケーションは、グラデーションストップコレクションを使用するレンダーターゲットを初期化した後にグラデーションストップコレクションを作成し、レンダーターゲットの再作成が必要になったときには、そのたびにグラデーションストップコレクションも再作成する必要があります。(リソースの詳細については、リソースの概要を参照してください。)

例

次の例では、グラデーションストップの配列を作成し、それを使用して ID2D1GradientStopCollection を作成します。

// グラデーションブラシで使用するグラデーションストップコレクションに
// 格納するグラデーションストップの配列を作成します。
ID2D1GradientStopCollection *pGradientStops = NULL;

D2D1_GRADIENT_STOP gradientStops[2];
gradientStops[0].color = D2D1::ColorF(D2D1::ColorF::Yellow, 1);
gradientStops[0].position = 0.0f;
gradientStops[1].color = D2D1::ColorF(D2D1::ColorF::ForestGreen, 1);
gradientStops[1].position = 1.0f;
// 事前に宣言された D2D1_GRADIENT_STOP 構造体の配列から
// ID2D1GradientStopCollection を作成します。
hr = m_pRenderTarget->CreateGradientStopCollection(
    gradientStops,
    2,
    D2D1_GAMMA_2_2,
    D2D1_EXTEND_MODE_CLAMP,
    &pGradientStops
    );

次のコード例では、ID2D1GradientStopCollection を使用して ID2D1LinearGradientBrush を作成します。

// グラデーションの方向を決定する線は、正方形の左上隅から始まり
// 右下隅で終わります。

if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateLinearGradientBrush(
        D2D1::LinearGradientBrushProperties(
            D2D1::Point2F(0, 0),
            D2D1::Point2F(150, 150)),
        pGradientStops,
        &m_pLinearGradientBrush
        );
}

コレクション内のグラデーションストップの数を取得します。

型: UINT32

コレクション内のグラデーションストップの数。

コレクションからグラデーションストップを D2D1_GRADIENT_STOP 構造体の配列にコピーします。

グラデーションストップは位置の順にコピーされます。最も小さい位置の値を持つグラデーションストップから始まり、最も大きい位置の値を持つグラデーションストップへと進みます。

グラデーションストップが補間されるガンマ空間を示します。

型: D2D1_GAMMA

グラデーションストップが補間されるガンマ空間。

正規化されたグラデーション範囲の外側でのグラデーションの動作を示します。

型: D2D1_EXTEND_MODE

[0,1] に正規化されたグラデーション範囲の外側でのグラデーションの動作。