ID2D1LinearGradientBrush インターフェイス (d2d1.h)

線形グラデーションを使用して領域を塗りつぶします。

継承

ID2D1LinearGradientBrush インターフェイスは、ID2D1Brush から継承されます。 ID2D1LinearGradientBrush には、次の種類のメンバーもあります。

メソッド

ID2D1LinearGradientBrush インターフェイスには、これらのメソッドがあります。

 
ID2D1LinearGradientBrush::GetEndPoint

線形グラデーションの終了座標を取得します。
ID2D1LinearGradientBrush::GetGradientStopCollection

この線形グラデーション ブラシに関連付けられている ID2D1GradientStopCollection を取得します。
ID2D1LinearGradientBrush::GetStartPoint

線形グラデーションの開始座標を取得します。
ID2D1LinearGradientBrush::SetEndPoint

ブラシの座標空間内の線形グラデーションの終了座標を設定します。
ID2D1LinearGradientBrush::SetStartPoint

ブラシの座標空間内の線形グラデーションの開始座標を設定します。

解説

ID2D1LinearGradientBrush は、ブラシの始点と終点の間の線に沿って直線状のグラデーションで領域を塗りつぶします。 ブラシ ID2D1GradientStopCollection によって定義されたグラデーションは、この線に対して垂直に押し出され、ブラシ変換 (指定されている場合) によって変換されます。

始点と終点はブラシ空間で記述され、ブラシの使用時にレンダー ターゲットにマップされます。 開始座標と終了座標は絶対座標であり、レンダー ターゲット サイズに対する相対座標ではないことに注意してください。 値 (0, 0) はレンダー ターゲットの左上隅にマップされ、値 (1, 1) は (0, 0) から斜めに 1 ピクセルをマップします。 非識別ブラシ変換またはレンダー ターゲット変換がある場合は、ブラシの始点と終点も変換されます。

塗りつぶす領域を完全に塗りつぶさないグラデーション軸を指定できます。 この場合、ID2D1GradientStopCollection で指定されたD2D1_EXTEND_MODEによって、残りの領域の塗りつぶし方法が決まります。

ID2D1LinearGradientBrush オブジェクトの作成

線形グラデーション ブラシを作成するには、ブラシを使用するレンダー ターゲットの ID2D1RenderTarget::CreateLinearGradientBrush メソッドを使用します。 ブラシは、ブラシを作成したレンダー ターゲット、またはそのレンダー ターゲットの互換性のあるターゲットでのみ使用できます。

線形グラデーション ブラシは、デバイスに依存するリソースです。アプリケーションでは、ブラシを使用するレンダー ターゲットを初期化した後に線形グラデーション ブラシを作成し、レンダー ターゲットを再作成する必要がある場合は常にブラシを再作成する必要があります。 (リソースの詳細については、「リソースの 概要」を参照してください)。

要件

   
サポートされている最小のクライアント Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー d2d1.h

関連項目

ID2D1Brush