iXpsOMGradientStop 接口 (xpsobjectmodel.h)

表示渐变中的单个颜色和位置。

继承

IXpsOMGradientStop 接口继承自 IUnknown 接口。 IXpsOMGradientStop 还具有以下类型的成员：

方法

IXpsOMGradientStop 接口具有以下方法。

注解

渐变停止点是为渐变区域内的位置定义的特定颜色。 渐变的颜色在渐变的渐变停止点之间变化。 渐变的面积和绝对位置由渐变接口定义。 偏移量是渐变区域内的相对位置，在 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 传播方法来填充渐变区域外部的空间。

下面的代码示例演示了如何创建此接口的实例。

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
}

要求

另请参阅

IXpsOMGradientBrush

IXpsOMObjectFactory：：CreateGradientStop

接口

XML 纸张规范