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 |