AcrylicBrush 类

定义

命名空间:

Windows.UI.Xaml.Media

使用半透明材料绘制一个区域，该材料使用多种效果，其中包括模糊效果和杂色纹理效果。

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

/// [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 AcrylicBrush : 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 AcrylicBrush : XamlCompositionBrushBase

function AcrylicBrush()

Public Class AcrylicBrush
Inherits XamlCompositionBrushBase

继承

Object IInspectable DependencyObject Brush XamlCompositionBrushBase AcrylicBrush

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

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

示例

提示

有关详细信息、设计指南和代码示例，请参阅 Acrylic 材料。

如果已安装 WinUI 2 库 应用，请单击此处 打开该应用并查看亚克力的实际应用。

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

注解

版本历史记录

Windows 版本	SDK 版本	增值
1903	18362	TintLuminosityOpacity

构造函数

AcrylicBrush()

初始化 AcrylicBrush 类的新实例。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.-ctor (，请参阅Windows 应用 SDK命名空间) 。

属性

AlwaysUseFallback	获取或设置一个值，该值指定画笔是否强制使用纯色回退颜色。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallback (，请参阅Windows 应用 SDK命名空间) 。
AlwaysUseFallbackProperty	标识 AlwaysUseFallback 依赖属性。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallbackProperty (，请参阅Windows 应用 SDK命名空间) 。
BackgroundSource	获取或设置一个值，该值指定画笔是从应用内容还是从应用窗口后的内容采样。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSource (，请参阅) Windows 应用 SDK命名空间。
BackgroundSourceProperty	标识 BackgroundSource 依赖属性。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSourceProperty (，请参阅Windows 应用 SDK命名空间) 。
CompositionBrush	获取或设置此 XAML 画笔使用的 CompositionBrush 。 (继承自 XamlCompositionBrushBase)
Dispatcher	获取与此 对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
FallbackColor	无法呈现 CompositionBrush 时用于呈现的颜色。 (继承自 XamlCompositionBrushBase)
Opacity	获取或设置 Brush 的不透明度。 (继承自 Brush)
RelativeTransform	获取或设置使用相对坐标应用到画笔的转换。 (继承自 Brush)
TintColor	获取或设置半透明亚克力材料的颜色色调。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.TintColor (，请参阅) Windows 应用 SDK命名空间。
TintColorProperty	标识 TintColor 依赖属性。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.TintColorProperty (，请参阅Windows 应用 SDK命名空间) 。
TintLuminosityOpacity	获取或设置 TintColor 与亚克力图面后面的基础像素之间的亮度。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacity (，请参阅) Windows 应用 SDK命名空间。
TintLuminosityOpacityProperty	标识 TintLuminosityOpacity 依赖属性。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacityProperty (，请参阅Windows 应用 SDK命名空间) 。
TintOpacity	获取或设置颜色色调的不透明度。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacity (，请参阅Windows 应用 SDK命名空间) 。
TintOpacityProperty	标识 TintOpacity 依赖属性。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacityProperty (，请参阅Windows 应用 SDK命名空间) 。
TintTransitionDuration	获取或设置 TintColor 更改时使用的自动切换动画的长度。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDuration (，请参阅) Windows 应用 SDK命名空间。
TintTransitionDurationProperty	标识 TintTransitionDuration 依赖属性。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDurationProperty (，请参阅Windows 应用 SDK命名空间) 。
Transform	获取或设置应用于画笔的转换。 (继承自 Brush)

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
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)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• 亚克力材料概述