语言

Brush 类

定义

命名空间:
Microsoft.UI.Xaml.Media
编辑

定义用于绘制图形对象的对象。 派生自 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, 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
派生
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
实现
IAnimationObject

注解

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

画笔作为 XAML 资源

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

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

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

画笔 派生类

画笔是多个派生类的父类，这些类实现绘制 UI 区域的实用画笔，或者是此类画笔的中间基类：

构造函数

名称 说明
Brush()

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

属性

名称 说明
Dispatcher

始终在 Windows 应用 SDK 应用中返回 null 。 请改用 DispatcherQueue 。

(继承自 DependencyObject)
DispatcherQueue

获取 DispatcherQueue 与此对象关联的对象。 表示 DispatcherQueue 即使代码是由非 UI 线程启动，也可以访问 DependencyObject UI 线程上的设施。

(继承自 DependencyObject)
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)

适用于

另请参阅