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 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	xpsobjectmodel.h

另请参阅

IXpsOMGradientBrush

IXpsOMLinearGradientBrush

IXpsOMObjectFactory：：CreateRadialGradientBrush

接口

XML 纸张规范