IXpsOMGradientStop 介面 (xpsobjectmodel.h)

代表漸層內的單一色彩和位置。

繼承

IXpsOMGradientStop介面繼承自IUnknown介面。 IXpsOMGradientStop 也有下列類型的成員：

方法

IXpsOMGradientStop介面具有這些方法。

IXpsOMGradientStop：：Clone 製作 IXpsOMGradientStop 介面的深層複本。
IXpsOMGradientStop：：GetColor 取得漸層停駐點的色彩值和色彩設定檔。
IXpsOMGradientStop：：GetOffset 取得漸層停駐點的位移值。
IXpsOMGradientStop：：GetOwner 取得包含漸層停駐點之 IXpsOMGradientBrush 介面的指標。
IXpsOMGradientStop：：SetColor 設定漸層停駐點的色彩值和色彩設定檔。
IXpsOMGradientStop：：SetOffset 設定漸層停駐點的位移位置。

備註

漸層停駐點是針對漸層區域內位置所定義的特定色彩。 漸層停駐點之間的漸層色彩會變更。 漸層的區域和絕對位置是由漸層介面所定義。 位移是漸層區域內的相對位置，測量介於 0.0 和 1.0 之間。 0.0 的位移是漸層的開頭，而 1.0 則是結尾。 您可以針對範圍內的任何位移定義漸層停駐點，包括終點。 此介面描述漸層中的一個和只有一個停駐點。

漸層路徑是連接線性漸層起點和終點的直線。 線性漸層的漸層區域是由起點與終點之間的區域所組成，包括這些點，並以直角向漸層路徑的雙向延伸。 散佈區域是漸層區域以外的區域。

漸層停駐點會在漸層路徑的特定位置定義色彩;色彩會沿著漸層停駐點之間的漸層路徑插入。 在下列範例中，漸層區域會填滿影像，因此沒有散佈區。

對於線性漸層筆刷中使用的漸層停駐點，0.0 的位移值會對應至漸層路徑的起點，而 1.0 的位移值則對應至結束點。 若要判斷這兩個點之間的漸層停駐點位置，中間位移值會在兩者之間插補。 下圖顯示兩個中繼漸層停駐點，一個位移為 0.25，另一個位在 0.75。

對於星形漸層筆刷中使用的漸層停駐點，0.0 的位移值會對應至漸層原點位置，而 1.0 的位移值會對應至系結漸層的橢圓形圓周。 介於 0.0 和 1.0 之間的位移會定義在漸層原點與周框橢圓形之間插補的橢圓形。 下圖顯示位移為 0.50 的中繼漸層停駐點， (漸層停駐點 1) 。 漸層使用 XPS_SPREAD_METHOD_REFLECT 散佈方法來填滿漸層區域以外的空間。

用來轉譯漸層的計算會在 XML 紙張規格中說明。

下列程式碼範例說明如何建立此介面的實例。

IXpsOMGradientStop    *newInterface;
// The following values are defined outside of 
// this example.
//  XPS_COLOR                    color;
//  IXpsOMColorProfileResource    *colorProfile;
//  FLOAT                        offset;

// 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->CreateGradientStop (
        &color,
        colorProfile,
        offset,
        &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

IXpsOMObjectFactory：：CreateGradientStop

介面

XML Paper Specification