RevealBrush 类

定义

命名空间:

Windows.UI.Xaml.Media

重要

RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。

画笔的基类，此类画笔使用组合效果和照明来实现视觉展示效果的设计处理。

适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Media.RevealBrush (，请参阅) Windows 应用 SDK命名空间。

public ref class RevealBrush : XamlCompositionBrushBase

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RevealBrush : XamlCompositionBrushBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class RevealBrush : XamlCompositionBrushBase

Public Class RevealBrush
Inherits XamlCompositionBrushBase

继承

Object Platform::Object IInspectable DependencyObject Brush XamlCompositionBrushBase RevealBrush

派生

Windows.UI.Xaml.Media.RevealBackgroundBrush

Windows.UI.Xaml.Media.RevealBorderBrush

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Fall Creators Update (在 10.0.16299.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v5.0 中引入)

示例

提示

有关详细信息、设计指南和代码示例，请参阅 使用画笔绘制背景、前景和轮廓。

如果已安装 WinUI 2 库 应用， 请打开该应用以查看操作中的控件。

• 获取 WinUI 2 库应用 (Microsoft Store)
• 获取源代码 (GitHub)

注解

XAML 附加属性

RevealBrush 是 XAML 附加属性的主机服务类。

为了支持 XAML 处理器访问附加属性，以及向代码公开等效 的 get 和 set 操作，每个 XAML 附加属性都有一对 Get 和 Set 访问器方法。 在代码中获取或设置值的另一种方法是使用依赖属性系统，调用 GetValue 或 SetValue 并将标识符字段作为依赖属性标识符传递。

附加属性	描述
状态	获取或设置一个值，该值指示使用此画笔的元素的指针状态。

构造函数

RevealBrush()

重要 RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。 为 RevealBrush 派生类提供基类初始化行为。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中用于 WinUI 的 Microsoft.UI.Xaml.Media.RevealBrush.-ctor (，请参阅Windows 应用 SDK命名空间) 。

属性

AlwaysUseFallback	重要 RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。 获取或设置一个值，该值指定画笔是否强制使用纯色回退颜色。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中用于 WinUI 的 Microsoft.UI.Xaml.Media.RevealBrush.AlwaysUseFallback (，请参阅) Windows 应用 SDK命名空间。
AlwaysUseFallbackProperty	重要 RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。 标识 AlwaysUseFallback 依赖属性。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中 WinUI 的 Microsoft.UI.Xaml.Media.RevealBrush.AlwaysUseFallbackProperty (，请参阅) Windows 应用 SDK命名空间。
Color	重要 RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。 获取或设置一个值，该值指定画笔的基本背景色。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中用于 WinUI 的 Microsoft.UI.Xaml.Media.RevealBrush.Color (，请参阅) Windows 应用 SDK命名空间。
ColorProperty	重要 RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。 标识 Color 依赖属性。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中 WinUI 的 Microsoft.UI.Xaml.Media.RevealBrush.ColorProperty (，请参阅) Windows 应用 SDK命名空间。
CompositionBrush	获取或设置此 XAML 画笔使用的 CompositionBrush 。 (继承自 XamlCompositionBrushBase)
Dispatcher	获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
FallbackColor	无法呈现 CompositionBrush 时用于呈现的颜色。 (继承自 XamlCompositionBrushBase)
Opacity	获取或设置 Brush 的不透明度。 (继承自 Brush)
RelativeTransform	获取或设置使用相对坐标应用到画笔的转换。 (继承自 Brush)
StateProperty	重要 RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。 标识 RevealBrush.State 附加属性。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中 WinUI 的 Microsoft.UI.Xaml.Media.RevealBrush.StateProperty (，请参阅) Windows 应用 SDK命名空间。
TargetTheme	重要 RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。 获取或设置一个值，该值指定用于绘制画笔和光线的主题，以确保将正确的合成效果配方用于所需的主题。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中用于 WinUI 的 Microsoft.UI.Xaml.Media.RevealBrush.TargetTheme (，请参阅) Windows 应用 SDK命名空间。
TargetThemeProperty	重要 RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。 标识 TargetTheme 依赖属性。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中 WinUI 的 Microsoft.UI.Xaml.Media.RevealBrush.TargetThemeProperty (，请参阅) Windows 应用 SDK命名空间。
Transform	获取或设置应用于画笔的转换。 (继承自 Brush)

附加属性

State

获取或设置一个值，该值指示使用此画笔的元素的指针状态。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中 WinUI 的 Microsoft.UI.Xaml.Media.RevealBrush.State (，请参阅Windows 应用 SDK命名空间) 。

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetState(UIElement)	重要 RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。 获取目标元素的 RevealBrush.State XAML 附加属性的值。 适用于 UWP 的等效 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.GetState (Windows.UI.Xaml.UIElement) (在Windows 应用 SDK中，请参阅Windows 应用 SDK命名空间) 。
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
OnConnected()	在屏幕上首次使用画笔绘制元素时调用。 在派生类中实现时，可以创建 CompositionBrush 实例，并通过设置 CompositionBrush 属性将其提供给框架。 当画笔不再用于绘制任何元素时，将调用 OnDisconnected。 (继承自 XamlCompositionBrushBase)
OnDisconnected()	当画笔不再用于绘制任何元素时调用。 在派生类中实现时，可以安全地释放合成画笔和其他合成资源。 如果稍后使用画笔在断开连接后绘制任何元素，则将再次调用 OnConnected。 (继承自 XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定义可进行动画处理的属性。 (继承自 Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	在派生类中重写时，定义一个可以进行动画处理的属性。 (继承自 Brush)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册通知函数，用于侦听此 DependencyObject 实例上特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetState(UIElement, RevealBrushState)	重要 RevealBrush 可用于“要求”部分中指定的操作系统。 但是，我们不建议使用它，因为它可能会在后续版本中更改或不可用。 设置目标元素的 RevealBrush.State XAML 附加属性的值。 适用于 UWP 的等效 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.SetState (Windows.UI.Xaml.UIElement，Microsoft.UI.Xaml.Media.RevealBrushState) (in Windows 应用 SDK，请参阅Windows 应用 SDK命名空间) 。
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)