BackdropMaterial 类

参考

定义

命名空间:: Microsoft.UI.Xaml.Controls

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

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

本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅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 Store 下载 WinUI 3 库和 WinUI 2 库。

还可以从 GitHub 获取这两种应用的源代码（对 WinUI 3 使用 main 分支，对 WinUI 2 使用 winui2 分支）。

注解

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

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

注意

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

XAML 附加属性

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

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

附加属性	说明
`ApplyToRootOrPageBackground`	将背景材料应用于 XAML 内容的根或背景。类型：Bool 标识符字段： ApplyToRootOrPageBackgroundProperty 访问器方法： GetApplyToRootOrPageBackground (Windows.UI.Xaml.Controls.Control) 、 SetApplyToRootOrPageBackground (Windows.UI.Xaml.Controls.Control、System.Boolean) 属性 `ApplyToRootOrPageBackground` 是一个布尔值，指示是否应用背景材料。