Brush 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
定义用于绘制图形对象的对象。 派生自 Brush 的类描述如何绘制区域。
public ref class Brush : DependencyObject, IAnimationObject/// [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 Brush : DependencyObject, IAnimationObject[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 class Brush : DependencyObject, IAnimationObjectPublic 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"/>
- 继承
- 派生
- 属性
- 实现
注解
有关 Brush 表示的 UI 绘图概念的示例和进一步说明，请参阅 XAML 画笔。
画笔作为 XAML 资源
可在 XAML (中声明的 Brush 类型（如 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 的中间基类。
构造函数
| Brush() |
为 画笔派生类提供基类初始化行为。 |
属性
| Dispatcher |
始终在Windows 应用 SDK应用中返回 |
| DispatcherQueue |
|
| Opacity |
获取或设置 Brush 的不透明度。 |
| OpacityProperty |
标识 Opacity 依赖属性。 |
| 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) |