ID2D1RenderTarget::CreateGradientStopCollection(constD2D1_GRADIENT_STOP*,UINT32,D2D1_GAMMA,D2D1_EXTEND_MODE,ID2D1GradientStopCollection**) method (d2d1.h)

Creates an ID2D1GradientStopCollection from the specified array of D2D1_GRADIENT_STOP structures.

Syntax

HRESULT CreateGradientStopCollection(
  const D2D1_GRADIENT_STOP    *gradientStops,
  UINT32                      gradientStopsCount,
  D2D1_GAMMA                  colorInterpolationGamma,
  D2D1_EXTEND_MODE            extendMode,
  ID2D1GradientStopCollection **gradientStopCollection
);

Parameters

gradientStops

Type: [in] D2D1_GRADIENT_STOP*

A pointer to an array of D2D1_GRADIENT_STOP structures.

gradientStopsCount

Type: [in] UINT

A value greater than or equal to 1 that specifies the number of gradient stops in the gradientStops array.

colorInterpolationGamma

Type: [in] D2D1_GAMMA

The space in which color interpolation between the gradient stops is performed.

extendMode

Type: [in] D2D1_EXTEND_MODE

The behavior of the gradient outside the [0,1] normalized range.

gradientStopCollection

Type: [out] ID2D1GradientStopCollection**

When this method returns, contains a pointer to a pointer to the new gradient stop collection.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement	Value
Target Platform	Windows
Header	d2d1.h (include D2d1.h)
Library	D2d1.lib
DLL	D2d1.dll

See also

Brushes Overview

D2D1_GRADIENT_STOP

How to Create a Linear Gradient Brush

How to Create a Radial Gradient Brush

ID2D1RenderTarget