D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES 構造体

ID2D1LinearGradientBrush のグラデーション軸の始点と終点を格納します。

構文

struct D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES {
  D2D1_POINT_2F startPoint;
  D2D1_POINT_2F endPoint;
};

メンバー

• startPoint
  D2D1_POINT_2F ブラシの座標空間では、グラデーション軸の始点。
• endPoint
  D2D1_POINT_2F ブラシの座標空間では、グラデーション軸の終点。

解説

このメソッドは、CreateLinearGradientBrush メソッドを使用して新しい ID2D1LinearGradientBrush オブジェクトを作成するときに使用します。便宜上、Direct2D には、D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES 構造体を作成するための D2D1::LinearGradientBrushProperties ヘルパー関数が用意されています。

次の図は、線状グラデーションの始点と終点を変更した場合のグラデーションの変化を示しています。最初のグラデーションでは、始点が (0,0)、終点が (150, 50) に設定されています。これにより、描画される領域の左上隅から左下隅までの対角線のグラデーションが作成されます。始点を (0, 25)、終点を (150, 25) に設定すると、水平方向のグラデーションが作成されます。同様に、始点を (75, 0)、終点を (75, 50) に設定すると、垂直方向のグラデーションが作成されます。始点を (0,50)、終点を (150, 0) に設定すると、描画される領域の左下隅から右上隅までの対角線のグラデーションが作成されます。

例

次の例では、CreateLinearGradientBrush メソッドを使用して、ID2D1LinearGradientBrush (m_pLinearGradientBrush) を作成します。D2D1::LinearGradientBrushProperties ヘルパー メソッドを使用して、始点 (0, 0) および終点 (150, 150) を格納する D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES 構造体を作成し、CreateLinearGradientBrush メソッドに渡します。

  // The line that determines the direction of the gradient starts at
// the upper-left corner of the square and ends at the lower-right corner.

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

この例では、コードが省略されています。完全な例については、「ブラシの種類の例」を参照してください。線状グラデーション ブラシの作成および使用の詳細については、「線状グラデーション ブラシを作成する方法」および「ブラシの概要」を参照してください。

要件

参照

線状グラデーション ブラシを作成する方法

ブラシの概要