LinearGradientBrush 类

定义

public ref class LinearGradientBrush sealed : GradientBrush

/// [Windows.Foundation.Metadata.Activatable(Microsoft.UI.Xaml.Media.ILinearGradientBrushFactory, 65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LinearGradientBrush final : GradientBrush

[Windows.Foundation.Metadata.Activatable(typeof(Microsoft.UI.Xaml.Media.ILinearGradientBrushFactory), 65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LinearGradientBrush : GradientBrush

Public NotInheritable Class LinearGradientBrush
Inherits GradientBrush

<LinearGradientBrush ...>
  oneOrMoreGradientStops
</LinearGradientBrush

继承

Object Platform::Object IInspectable DependencyObject Brush GradientBrush LinearGradientBrush

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

示例

下面的示例使用四种颜色创建了一种线性渐变效果，并用它来绘制 Rectangle 。

<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>

注解

LinearGradientBrush 是一种 Brush 类型，用于许多可能的 UI 属性，这些属性使用 Brush 填充应用 UI 中对象的部分或全部可视区域。 使用 Brush 值的一些最常用的属性的示例包括： Control.Background、 Control.Foreground、 Shape.Fill、 Control.BorderBrush、 Panel.Background、 TextBlock.Foreground。 LinearGradientBrush 是更常用 SolidColorBrush 类型的替代方法。

LinearGradientBrush 的 StartPoint 和 EndPoint 属性描述相对坐标空间中的两个点。 这会为渐变创建方向，通常指定水平渐变或垂直渐变。 也可以使用对角渐变。 LinearGradientBrush 通常具有两个或更多 GradientStop 值，该属性 (有序集合) 。 每个 GradientStop 指定一个 Color 和一个 Offset。 偏移量 表示 0 (StartPoint) 到 1 (EndPoint) 沿渐变的位置，画笔的实际像素长度及其渐变将根据将 LinearGradientBrush 作为值的 UI 进行调整。 有关如何定义 Offset 值以及如何关联 Offset、 StartPoint 和 EndPoint 的详细信息，请参阅 XAML 画笔。 通常使用

可以将 “透明 ”值用于其中一种 GradientStop 颜色。 尽管这不会在视觉上对 UI 应用任何更改， (它是透明的) ，但可以检测到这一点以进行命中测试。 有关命中测试的详细信息，请参阅 鼠标交互的“命中测试”部分。

LinearGradientBrush 的 GradientStop 值可以作为过渡或装饰动画的一部分进行动画处理。 使用可对 Color 值进行动画处理的专用动画类型之一。 这通常涉及 .(GradientStop.Color) 要成为 Storyboard.TargetProperty 值的较长属性路径的一部分。 有关属性目标以及如何使用 Brush 值对属性进行动画处理的详细信息，请参阅 情节提要动画。

画笔作为 XAML 资源

可在 XAML (SolidColorBrush、LinearGradientBrush、ImageBrush) 中声明的每个画笔类型都旨在定义为资源，以便你可以在整个应用中重复使用该画笔作为资源。 为 Brush 类型显示的 XAML 语法适用于将画笔定义为资源。 将画笔声明为资源时，还需要一个 x：Key 属性 ，稍后将使用该属性从其他 UI 定义中引用该资源。 有关 XAML 资源和如何使用 x：Key 属性的详细信息，请参阅 ResourceDictionary 和 XAML 资源引用。

将画笔声明为资源的优点是减少了构造 UI 所需的运行时对象数：画笔现在共享为对象图的多个部分提供值的通用资源。

如果查看Windows 运行时 XAML 控件的现有控件模板定义，你将看到模板广泛使用画笔资源 (尽管这些资源通常是 SolidColorBrush，而不是 LinearGradientBrush) 。 其中许多资源是系统资源，它们使用 {ThemeResource} 标记扩展 作为资源引用，而不是 {StaticResource} 标记扩展。 有关如何在自己的控件模板 XAML 中使用系统资源画笔的详细信息，请参阅 XAML 主题资源。

构造函数

属性

方法

适用于

另请参阅

• GradientBrush
• SolidColorBrush
• RadialGradientBrush
• XAML 画笔
• ResourceDictionary 和 XAML 资源引用