ID2D1GradientStopCollection 接口 (d2d1.h)

表示线性渐变画笔和径向渐变画笔 D2D1_GRADIENT_STOP 对象的集合。

继承

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

• 方法

方法

ID2D1GradientStopCollection 接口包含以下方法。

ID2D1GradientStopCollection：：GetColorInterpolationGamma 指示渐变停止点内插的伽玛空间。
ID2D1GradientStopCollection：：GetExtendMode 指示渐变在规范化渐变范围之外的行为。
ID2D1GradientStopCollection：：GetGradientStopCount 检索集合中的渐变停止点数。
ID2D1GradientStopCollection：：GetGradientStops 将集合中的渐变停点复制到D2D1_GRADIENT_STOP结构的数组中。

备注

创建 ID2D1GradientStopCollection 对象

若要创建 ID2D1GradientStopCollection，请使用 ID2D1RenderTarget：：CreateGradientStopCollection 方法。

渐变停止集合是依赖于设备的资源：应用程序应在初始化将使用渐变停止集合的呈现目标后创建渐变停止集合，并在呈现目标需要重新创建时重新创建渐变停止集合。 (有关资源的详细信息，请参阅 资源概述。)

示例

以下示例创建渐变停止点数组，然后使用它们创建 ID2D1GradientStopCollection。

// Create an array of gradient stops to put in the gradient stop
// collection that will be used in the gradient brush.
ID2D1GradientStopCollection *pGradientStops = NULL;

D2D1_GRADIENT_STOP gradientStops[2];
gradientStops[0].color = D2D1::ColorF(D2D1::ColorF::Yellow, 1);
gradientStops[0].position = 0.0f;
gradientStops[1].color = D2D1::ColorF(D2D1::ColorF::ForestGreen, 1);
gradientStops[1].position = 1.0f;
// Create the ID2D1GradientStopCollection from a previously
// declared array of D2D1_GRADIENT_STOP structs.
hr = m_pRenderTarget->CreateGradientStopCollection(
    gradientStops,
    2,
    D2D1_GAMMA_2_2,
    D2D1_EXTEND_MODE_CLAMP,
    &pGradientStops
    );

下一个代码示例使用 ID2D1GradientStopCollection 创建 ID2D1LinearGradientBrush。

// The line that determines the direction of the gradient starts at
// the upper-left corner of the square and ends at the lower-right corner.

if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateLinearGradientBrush(
        D2D1::LinearGradientBrushProperties(
            D2D1::Point2F(0, 0),
            D2D1::Point2F(150, 150)),
        pGradientStops,
        &m_pLinearGradientBrush
        );
}

要求

最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	d2d1.h

另请参阅

ID2D1Resource