MicaBackdrop 类

定义

命名空间:

Microsoft.UI.Xaml.Media

表示将 Mica 材料应用于支持的 XAML 图面（例如 Window）的系统背景。

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MicaBackdrop : SystemBackdrop

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class MicaBackdrop : SystemBackdrop

Public Class MicaBackdrop
Inherits SystemBackdrop

继承

Object IInspectable DependencyObject SystemBackdrop MicaBackdrop

属性

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

示例

<Window
    ... >

    <Window.SystemBackdrop>
        <MicaBackdrop Kind="BaseAlt"/>
    </Window.SystemBackdrop>

</Window>

public MainWindow()
{
    this.InitializeComponent();

    SystemBackdrop = new MicaBackdrop() 
                        { Kind = MicaKind.BaseAlt };
}

注解

可以使用 MicaBackdrop 将 Mica 材料 应用于实现 ICompositionSupportsSystemBackdrop 接口的对象，通常是 XAML 窗口。

并非所有系统都支持 Mica。 如果不支持，则使用纯色而不是 Mica 效果。

构造函数

MicaBackdrop()

初始化 MicaBackdrop 类的新实例。

属性

Dispatcher	始终在Windows 应用 SDK应用中返回 null 。 请改用 DispatcherQueue 。 (继承自 DependencyObject)
DispatcherQueue	获取 DispatcherQueue 与此 对象关联的 。 DispatcherQueue表示可以访问 DependencyObject UI 线程上的 的功能，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
Kind	获取或设置 显示的背景 MicaBackdrop 类型。
KindProperty	标识 Kind 依赖项属性。

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetDefaultSystemBackdropConfiguration(ICompositionSupportsSystemBackdrop, XamlRoot)	检索可传递给 ISystemBackdropControllerWithTargets.SetSystemBackdropConfiguration的默认 SystemBackdropConfiguration 对象。 (继承自 SystemBackdrop)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
OnDefaultSystemBackdropConfigurationChanged(ICompositionSupportsSystemBackdrop, XamlRoot)	重写此方法，以在更改返回 GetDefaultSystemBackdropConfiguration 的对象时调用。 如果使用自定义 SystemBackdropConfiguration，这非常有用。 (继承自 SystemBackdrop)
OnTargetConnected(ICompositionSupportsSystemBackdrop, XamlRoot)	当此对象附加到有效容器时调用;例如，在 上 Window.SystemBackdrop设置 时。 (继承自 SystemBackdrop)
OnTargetDisconnected(ICompositionSupportsSystemBackdrop)	从其容器中清除此对象时调用。 (继承自 SystemBackdrop)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册一个通知函数，用于侦听此 DependencyObject 实例上特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• MicaController
• SystemBackdrop
• SystemBackdrop
• DesktopAcrylicBackdrop
• Mica 材质