IXpsOMLinearGradientBrush 接口 (xpsobjectmodel.h)

指定线性渐变，即沿矢量的颜色渐变。

继承

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

另请参阅

IXpsOMGradientBrush

IXpsOMGradientStop

IXpsOMObjectFactory：：CreateLinearGradientBrush

IXpsOMRadialGradientBrush

接口

XML 纸张规范