Brush 类

定义

命名空间:

Windows.UI.Xaml.Media

定义用于绘制图形对象的对象。 派生自 Brush 的类描述如何绘制区域。

public ref class Brush : DependencyObject, IAnimationObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Brush : DependencyObject, IAnimationObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject, IAnimationObject

Public Class Brush
Inherits DependencyObject
Implements IAnimationObject

<object property="predefinedColorName"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scR,scG,scB"/>
- or -
<object property="sc#scA,scR,scG,scB"/>

继承

Object Platform::Object IInspectable DependencyObject Brush

派生

Windows.UI.Xaml.Media.GradientBrush

Windows.UI.Xaml.Media.SolidColorBrush

Windows.UI.Xaml.Media.TileBrush

Windows.UI.Xaml.Media.XamlCompositionBrushBase

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IAnimationObject

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

有关 Brush 表示的 UI 绘图概念的示例和进一步说明，请参阅 使用画笔。

画笔作为 XAML 资源

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

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

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

画笔 派生类

Brush 是多个派生类的父类，这些类要么实现绘制 UI 区域的实际画笔，要么是此类画笔的中间基类：

• GradientBrush： LinearGradientBrush 的中间基类。
• SolidColorBrush：这是迄今为止最常用的画笔。
• TileBrush： ImageBrush 的中间基类。

版本历史记录

Windows 版本	SDK 版本	增值
1809	17763	PopulatePropertyInfo
1809	17763	PopulatePropertyInfoOverride

构造函数

Brush()

为 Brush 派生类提供基类初始化行为。

属性

Dispatcher	获取与此 对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
Opacity	获取或设置 Brush 的不透明度。
OpacityProperty	标识 不透明度 依赖属性。
RelativeTransform	获取或设置使用相对坐标应用到画笔的转换。
RelativeTransformProperty	标识 RelativeTransform 依赖属性。
Transform	获取或设置应用于画笔的转换。
TransformProperty	标识 Transform 依赖属性。

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定义可进行动画处理的属性。
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	在派生类中重写时，定义可进行动画处理的属性。
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册一个通知函数，用于侦听此 DependencyObject 实例上特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• DependencyObject
• SolidColorBrush
• Color
• Colors
• 使用画笔
• Image 和 ImageBrush
• ResourceDictionary 和 XAML 资源引用