IXpsOMLinearGradientBrush インターフェイス (xpsobjectmodel.h)

ベクトルに沿った色グラデーションである線形グラデーションを指定します。

継承

IXpsOMLinearGradientBrush インターフェイスは、IXpsOMGradientBrush から継承します。 IXpsOMLinearGradientBrush には、次の種類のメンバーもあります。

メソッド

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

IXpsOMLinearGradientBrush::Clone インターフェイスのディープ コピーを作成します。 (IXpsOMLinearGradientBrush.Clone)
IXpsOMLinearGradientBrush::GetEndPoint グラデーションの終点を取得します。
IXpsOMLinearGradientBrush::GetStartPoint グラデーションの始点を取得します。
IXpsOMLinearGradientBrush::SetEndPoint グラデーションの終点を設定します。
IXpsOMLinearGradientBrush::SetStartPoint グラデーションの始点を設定します。

注釈

次の図では、線形グラデーションの始点と終点は、グラデーション パスの始点と終点でもあります。これは、それらの点を結ぶ直線です。

線形グラデーションのグラデーション領域は、始点と終点を含む と の間の領域であり、グラデーション パスに対して直角に両方向に拡張されます。 広がり領域は、グラデーション領域の外側にあるジオメトリの領域です。

グラデーションの分岐点は、グラデーション パスに沿って特定の場所で色を定義するために使用されます。 図では、グラデーションの分岐点 0 はグラデーション パスの始点に位置し、グラデーションの分岐点 1 は終点にあります。 XPS_SPREAD_METHOD_PADスプレッド法は、スプレッドエリアを埋めるために使用されます。

次のコード例は、このインターフェイスのインスタンスを作成する方法を示しています。

IXpsOMLinearGradientBrush    *newInterface;
// The following values are defined outside of 
// this example.
//  IXpsOMGradientStop       *gradStop1, *gradStop2;
//  XPS_POINT                startPoint, endPoint;

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreateLinearGradientBrush (
        gradStop1,
        gradStop2,
        &startPoint,
        &endPoint,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

要件

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

こちらもご覧ください

IXpsOMGradientBrush

IXpsOMGradientStop

IXpsOMObjectFactory::CreateLinearGradientBrush

IXpsOMRadialGradientBrush

インターフェイス

XML Paper Specification