CD2DLinearGradientBrush 类

项目
10/12/2023

ID2D1LinearGradientBrush 的包装器。

语法

class CD2DLinearGradientBrush : public CD2DGradientBrush;

成员

公共构造函数

名称	描述
CD2DLinearGradientBrush::CD2DLinearGradientBrush	构造 CD2DLinearGradientBrush 对象。
CD2DLinearGradientBrush::~CD2DLinearGradientBrush	析构函数。在销毁 D2D 线性渐变画笔对象时调用。

公共方法

名称	描述
CD2DLinearGradientBrush::Attach	将现有资源接口附加到对象
CD2DLinearGradientBrush::Create	创建 CD2DLinearGradientBrush。（替代 CD2DResource::Create。）
CD2DLinearGradientBrush::Destroy	销毁 CD2DLinearGradientBrush 对象。（替代 CD2DGradientBrush::Destroy。）
CD2DLinearGradientBrush::Detach	从对象中拆离资源接口
CD2DLinearGradientBrush::Get	返回 ID2D1LinearGradientBrush 接口
CD2DLinearGradientBrush::GetEndPoint	检索线性渐变的终止坐标
CD2DLinearGradientBrush::GetStartPoint	检索线性渐变的起始坐标
CD2DLinearGradientBrush::SetEndPoint	设置线性渐变在画笔坐标空间中的结束坐标
CD2DLinearGradientBrush::SetStartPoint	设置线性渐变在画笔坐标空间中的起始坐标

公共运算符

“属性”	描述
CD2DLinearGradientBrush::operator ID2D1LinearGradientBrush*	返回 ID2D1LinearGradientBrush 接口

受保护的数据成员

名称	描述
CD2DLinearGradientBrush::m_LinearGradientBrushProperties	渐变的起点和终点。
CD2DLinearGradientBrush::m_pLinearGradientBrush	指向 ID2D1LinearGradientBrush 的指针。

继承层次结构

CD2DLinearGradientBrush

要求

标头：afxrendertarget.h

CD2DLinearGradientBrush::~CD2DLinearGradientBrush

析构函数。在销毁 D2D 线性渐变画笔对象时调用。

virtual ~CD2DLinearGradientBrush();

CD2DLinearGradientBrush::Attach

将现有资源接口附加到对象

void Attach(ID2D1LinearGradientBrush* pResource);

参数

pResource
现有资源接口。不能为 NULL

CD2DLinearGradientBrush::CD2DLinearGradientBrush

构造 CD2DLinearGradientBrush 对象。

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

参数

pParentTarget
指向渲染目标的指针。

gradientStops
指向 D2D1_GRADIENT_STOP 结构的数组的指针。

gradientStopsCount
大于或等于 1 的值，该值指定 gradientStops 数组中的渐变停止点数。

LinearGradientBrushProperties
渐变的起点和终点。

colorInterpolationGamma
执行梯度停止点之间的颜色内插的空间。

extendMode
[0,1] 规范化范围之外的渐变行为。

pBrushProperties
指向画笔不透明度和转换的指针。

bAutoDestroy
指示对象将由所有者 (pParentTarget) 销毁。

CD2DLinearGradientBrush::Create

创建 CD2DLinearGradientBrush。

virtual HRESULT Create(CRenderTarget* pRenderTarget);

参数

pRenderTarget
指向渲染目标的指针。

返回值

如果该方法成功，则它会返回 S_OK。否则，它将返回 HRESULT 错误代码。

CD2DLinearGradientBrush::Destroy

销毁 CD2DLinearGradientBrush 对象。

virtual void Destroy();

CD2DLinearGradientBrush::Detach

从对象中拆离资源接口

ID2D1LinearGradientBrush* Detach();

返回值

指向拆离的资源接口的指针。

CD2DLinearGradientBrush::Get

返回 ID2D1LinearGradientBrush 接口

ID2D1LinearGradientBrush* Get();

返回值

指向 ID2D1LinearGradientBrush 接口的指针，如果对象尚未初始化，则为 NULL。

CD2DLinearGradientBrush::GetEndPoint

检索线性渐变的终止坐标

CD2DPointF GetEndPoint() const;

返回值

线性渐变在画笔坐标空间中的二维终止坐标

CD2DLinearGradientBrush::GetStartPoint

检索线性渐变的起始坐标

CD2DPointF GetStartPoint() const;

返回值

线性渐变在画笔坐标空间中的二维起始坐标

CD2DLinearGradientBrush::m_LinearGradientBrushProperties

渐变的起点和终点。

D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES m_LinearGradientBrushProperties;

CD2DLinearGradientBrush::m_pLinearGradientBrush

指向 ID2D1LinearGradientBrush 的指针。

ID2D1LinearGradientBrush* m_pLinearGradientBrush;

CD2DLinearGradientBrush::operator ID2D1LinearGradientBrush*