IXpsOMRadialGradientBrush 介面 (xpsobjectmodel.h)

指定星形漸層。

繼承

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

方法

IXpsOMRadialGradientBrush 介面具有這些方法。

IXpsOMRadialGradientBrush：：Clone 製作介面的深層複本。 (IXpsOMRadialGradientBrush.Clone)
IXpsOMRadialGradientBrush：：GetCenter 取得星形漸層區域橢圓形的中心點。
IXpsOMRadialGradientBrush：：GetGradientOrigin 取得星形漸層的原點。
IXpsOMRadialGradientBrush：：GetRadiiSizes 取得定義星形漸層區域橢圓形的弧度大小。
IXpsOMRadialGradientBrush：：SetCenter 設定星形漸層區域橢圓形的中心點。
IXpsOMRadialGradientBrush：：SetGradientOrigin 設定星形漸層的原點。
IXpsOMRadialGradientBrush：：SetRadiiSizes 設定定義星形漸層區域橢圓形的弧度大小。

備註

如下圖所示，星形漸層的漸層區域是由中心點和從中心點延伸的 x 和 y 弧度所描述的橢圓形所括住的區域。 散布區域是該橢圓形以外的區域。 漸層路徑 (未顯示) 是漸層原點與系結漸層區域的橢圓形之間繪製的星形線。

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

IXpsOMRadialGradientBrush    *newInterface;
// The following values are defined outside of 
// this example.
//  IXpsOMGradientStop       *gradStop1, *gradStop2;
//  XPS_POINT                centerPoint, gradientOrigin;
//  XPS_SIZE                 radiiSizes;

// 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->CreateRadialGradientBrush (
        gradStop1,
        gradStop2,
        &centerPoint,
        &gradientOrigin,
        &radiiSizes,
        &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

IXpsOMLinearGradientBrush

IXpsOMObjectFactory：：CreateRadialGradientBrush

介面

XML Paper Specification