LinearGradientBrush 线性渐变画刷的使用

用于 Silverlight 的 .NET Framework 类库

LinearGradientBrush 类

使用线性渐变绘制区域。

命名空间：  System.Windows.Media

程序集：  System.Windows（在 System.Windows.dll 中） 

 语法 

Visual Basic（声明） 

Public NotInheritable Class LinearGradientBrush _ Inherits GradientBrush

Visual Basic (用法) 

Dim instance As LinearGradientBrush

C# 

public sealed class LinearGradientBrush : GradientBrush

XAML 隐式集合用法 

<LinearGradientBrush ...> oneOrMoreGradientStops</LinearGradientBrush

XAML 值

oneOrMoreGradientStops 

一个或多个 GradientStop 对象元素。当代码在运行时访问 GradientStops 属性时，此处定义的对象元素成为 GradientStopCollection 的成员。

 备注 

LinearGradientBrush 使用线性渐变绘制区域。线性渐变沿直线定义渐变。该直线的终点由线性渐变的 StartPoint 和 EndPoint 属性定义。LinearGradientBrush 画笔沿此直线绘制其 GradientStops。

默认的线性渐变是沿对角方向进行的。默认情况下，线性渐变的 StartPoint 是被绘制区域的左上角值为 0,0 的 Point，其 EndPoint 是被绘制区域的右下角值为 1,1 的 Point。所得渐变的颜色是沿着对角方向路径插入的。

下面的插图显示了对角方向的渐变。图中添加了一条线，用于突出显示渐变从起点到终点的插值路径。

对角方向的线性渐变

下一幅插图显示的是同一线性渐变，但它具有突出显示的渐变停止点。

具有突出显示的渐变停止点的对角线性渐变

可以指定未完全填充所绘制区域的渐变轴。出现这种情况时，SpreadMethod 属性确定其余区域的绘制方式。

 示例 

下面的示例创建了一个具有四种颜色的线性渐变，并且使用该渐变绘制 Rectangle。

XAML 

复制代码 

<StackPanel>

 <!-- This rectangle is painted with a vertical linear gradient. -->

 <Rectangle Width="200" Height="100"> 

<Rectangle.Fill>

 <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">

 <GradientStop Color="Yellow" Offset="0.0" /> 

<GradientStop Color="Red" Offset="0.25" />

 <GradientStop Color="Blue" Offset="0.75" /> 

<GradientStop Color="LimeGreen" Offset="1.0" /> 

</LinearGradientBrush> 

</Rectangle.Fill> 

</Rectangle>

</StackPanel>

下图演示了结果渐变。渐变轴用虚线标记，而渐变停止点用圆圈标记。

垂直渐变的渐变轴