BackdropMaterial 类

定义

命名空间:

Microsoft.UI.Xaml.Controls

帮助程序类，用于将背景材料应用于 XAML 内容的根目录。

本文档适用于适用于 UWP 的 WinUI 2（对于 Windows 应用 SDK中的 WinUI，请参阅 Windows 应用 SDK 命名空间）。

public ref class BackdropMaterial : DependencyObject

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BackdropMaterial : DependencyObject

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class BackdropMaterial : DependencyObject

Public Class BackdropMaterial
Inherits DependencyObject

<Page muxc:BackdropMaterial.ApplyToRootOrPageBackground="True">
    pageContent
</Page>
-or-
<Frame muxc:BackdropMaterial.ApplyToRootOrPageBackground="True">
    appContent
</Frame>

继承

DependencyObject

BackdropMaterial

属性

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

示例

提示

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

WinUI 3 库 和 WinUI 2 库 应用包括大多数 WinUI 3 和 WinUI 2 控件、特性和功能的交互式示例。

如果已安装，请单击以下链接将其打开：WinUI 3 库 或 WinUI 2 库。

如果未安装它们，可以从 Microsoft 应用商店下载 WinUI 3 库 和 WinUI 2 库。

还可以从 GitHub 获取两者的源代码（使用 WinUI 3 的主 分支和 winUI 2 的 winui2 分支）。

注解

背景材料是从 XAML 内容后面的区域获取的像素源创建的 材料。

BackdropMaterial 类使你可以将背景材料（Mica）应用到应用程序的合成目标。 它在必要时设置中性颜色的 XAML 画笔，自动支持主题更改、下层版本和设备状态。

谨慎

应用背景材料时，不要在 UI 内容上设置 Background 属性。 背景必须是透明的，以便背景材料通过显示。

XAML 附加属性

BackdropMaterial 是 ApplyToRootOrPageBackgroundXAML 附加属性的主机服务类。

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

Attached 属性	描述
ApplyToRootOrPageBackground	将背景材料应用于 XAML 内容的根或背景。 类型：Bool 标识符字段：ApplyToRootOrPageBackgroundProperty 访问器方法：GetApplyToRootOrPageBackground（Windows.UI.Xaml.Controls.Control），SetApplyToRootOrPageBackground（Windows.UI.Xaml.Controls.Control，System.Boolean） ApplyToRootOrPageBackground 属性是一个布尔值，该值指示是否应用背景材料。

属性

ApplyToRootOrPageBackgroundProperty

标识 BackdropMaterial.ApplyToRootOrPageBackground XAML 附加属性。 本文档适用于适用于 UWP 的 WinUI 2（对于 Windows 应用 SDK中的 WinUI，请参阅 Windows 应用 SDK 命名空间）。

附加属性

ApplyToRootOrPageBackground

将背景材料应用于 XAML 内容的根或背景。 本文档适用于适用于 UWP 的 WinUI 2（对于 Windows 应用 SDK中的 WinUI，请参阅 Windows 应用 SDK 命名空间）。

方法

GetApplyToRootOrPageBackground(Control)	获取目标元素的 BackdropMaterial.ApplyToRootOrPageBackground XAML 附加属性的值。 本文档适用于适用于 UWP 的 WinUI 2（对于 Windows 应用 SDK中的 WinUI，请参阅 Windows 应用 SDK 命名空间）。
SetApplyToRootOrPageBackground(Control, Boolean)	设置目标元素的 BackdropMaterial.ApplyToRootOrPageBackground XAML 附加属性的值。 本文档适用于适用于 UWP 的 WinUI 2（对于 Windows 应用 SDK中的 WinUI，请参阅 Windows 应用 SDK 命名空间）。

另请参阅

• Mica