IXpsOMLinearGradientBrush 介面 (xpsobjectmodel.h)

發行項
12/22/2023

指定線性漸層，這是沿著向量的色彩漸層。

繼承

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