CD2DGradientBrush Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CD2DGradientBrush Class.

The base class of the CD2DLinearGradientBrush and the CD2DRadialGradientBrush classes.

class CD2DGradientBrush : public CD2DBrush;  

Public Constructors

NameDescription
CD2DGradientBrush::CD2DGradientBrushConstructs a CD2DGradientBrush object.
CD2DGradientBrush::~CD2DGradientBrushThe destructor. Called when a D2D gradient brush object is being destroyed.

Protected Methods

NameDescription
CD2DGradientBrush::DestroyDestroys a CD2DGradientBrush object. (Overrides CD2DBrush::Destroy.)

Protected Data Members

NameDescription
CD2DGradientBrush::m_arGradientStopsArray of the D2D1_GRADIENT_STOP structures.
CD2DGradientBrush::m_colorInterpolationGammaThe space in which color interpolation between the gradient stops is performed.
CD2DGradientBrush::m_extendModeThe behavior of the gradient outside the [0,1] normalized range.
CD2DGradientBrush::m_pGradientStopsA pointer to an array of D2D1_GRADIENT_STOP structures.

CObject

CD2DResource

CD2DBrush

CD2DGradientBrush

Header: afxrendertarget.h

The destructor. Called when a D2D gradient brush object is being destroyed.

virtual ~CD2DGradientBrush();

Constructs a CD2DGradientBrush object.

CD2DGradientBrush(
    CRenderTarget* pParentTarget,  
    const D2D1_GRADIENT_STOP* gradientStops,  
    UINT gradientStopsCount,  
    D2D1_GAMMA colorInterpolationGamma = D2D1_GAMMA_2_2,  
    D2D1_EXTEND_MODE extendMode = D2D1_EXTEND_MODE_CLAMP,  
    CD2DBrushProperties* pBrushProperties = NULL,  
    BOOL bAutoDestroy = TRUE);

Parameters

pParentTarget
A pointer to the render target.

gradientStops
A pointer to an array of D2D1_GRADIENT_STOP structures.

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

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

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

pBrushProperties
A pointer to the opacity and transformation of a brush.

bAutoDestroy
Indicates that the object will be destroyed by owner (pParentTarget).

Destroys a CD2DGradientBrush object.

virtual void Destroy();

Array of the D2D1_GRADIENT_STOP structures.

CArray<D2D1_GRADIENT_STOP, D2D1_GRADIENT_STOP> m_arGradientStops;  

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

D2D1_GAMMA m_colorInterpolationGamma;  

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

D2D1_EXTEND_MODE m_extendMode;  

A pointer to an array of D2D1_GRADIENT_STOP structures.

ID2D1GradientStopCollection* m_pGradientStops;  

Classes

Show: