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 |