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 |