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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	xpsobjectmodel.h

另請參閱

IXpsOMGradientBrush

IXpsOMGradientStop

IXpsOMObjectFactory：：CreateLinearGradientBrush

IXpsOMRadialGradientBrush

介面

XML Paper Specification