ID2D1LinearGradientBrush 接口 (d2d1.h)

使用线性渐变绘制区域。

继承

ID2D1LinearGradientBrush 接口继承自 ID2D1BrushID2D1LinearGradientBrush 也包含以下类型的成员:

方法

ID2D1LinearGradientBrush 接口具有以下方法。

 
ID2D1LinearGradientBrush::GetEndPoint

检索线性渐变的结束坐标。
ID2D1LinearGradientBrush::GetGradientStopCollection

检索与此线性渐变画笔关联的 ID2D1GradientStopCollection。
ID2D1LinearGradientBrush::GetStartPoint

检索线性渐变的起始坐标。
ID2D1LinearGradientBrush::SetEndPoint

设置画笔坐标空间中线性渐变的结束坐标。
ID2D1LinearGradientBrush::SetStartPoint

设置画笔坐标空间中线性渐变的起始坐标。

注解

ID2D1LinearGradientBrush 沿画笔起点和终点之间的线条绘制线性渐变的区域。 由画笔 ID2D1GradientStopCollection 定义的渐变垂直延伸,然后由画笔转换 (转换(如果指定) )。

起点和终点在画笔空间中描述,并在使用画笔时映射到呈现目标。 请注意,起始坐标和结束坐标是绝对的,而不是相对于呈现目标大小。 值 (0, 0) 映射到呈现目标的左上角,而值 (1, 1) 映射一个像素,对角线距离 (0, 0) 。 如果存在非识别画笔转换或呈现目标转换,则画笔起点和终点也会转换。

可以指定不完全填充正在绘制的区域的渐变轴。 发生这种情况时,ID2D1GradientStopCollection 指定的D2D1_EXTEND_MODE将确定剩余区域的绘制方式。

创建 ID2D1LinearGradientBrush 对象

若要创建线性渐变画笔,请使用将使用画笔的呈现目标的 ID2D1RenderTarget::CreateLinearGradientBrush 方法。 画笔只能与创建它的呈现器目标一起使用,或与该呈现目标的兼容目标一起使用。

线性渐变画笔是一种依赖于设备的资源:应用程序应在初始化将使用画笔的呈现器目标后创建线性渐变画笔,并在呈现目标需要重新创建时重新创建画笔。 (有关资源的详细信息,请参阅 资源概述。)

要求

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

另请参阅

ID2D1Brush