SystemBackdrop 類別

定義

命名空間:

Microsoft.UI.Xaml.Media

用來轉譯Mica和壓克力等材質的自定義系統基類。

public ref class SystemBackdrop : DependencyObject

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SystemBackdrop : DependencyObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class SystemBackdrop : DependencyObject

Public Class SystemBackdrop
Inherits DependencyObject

繼承

Object Platform::Object IInspectable DependencyObject SystemBackdrop

衍生

Microsoft.UI.Xaml.Media.DesktopAcrylicBackdrop

Microsoft.UI.Xaml.Media.MicaBackdrop

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

此範例示範使用 MicaController實作的自定義系統基底類別。

呼叫base OnTargetConnected 方法會初始化 GetDefaultSystemBackdropConfiguration 傳回的預設組態物件，以反映影響此 SystemBackdrop 實例的環境變更，) 所 connectedTarget, XamlRoot 指定的 (。

雖然此頁面上的範例不支援共用 MicaSystemBackdrop 實例 (例如， Window1.SystemBackdrop = Window2.SystemBackdrop = myMicaSystemBackdrop) ，但內建 MicaBackdrop 和 DesktopAcrylicBackdrop 材質可支援這類共用。 若要在自定義材質中實作共用，請向量化支援 ISystemBackdropController 記憶體，以針對每個使用 (內容保留個別的實例，例如，透過) 上的 connectedTarget 地圖索引鍵。 請注意，同樣地，SystemBackdrop會將 GetDefaultSystemBackdropConfiguration 傳回的相關聯預設組態物件向量化，確保設定會在共享時SystemBackdrop反映每個使用內容。

<Window
    ... >
    <Window.SystemBackdrop>
        <local:MicaSystemBackdrop/>
    </Window.SystemBackdrop>

    <!-- XAML content -->

</Window>

public class MicaSystemBackdrop : SystemBackdrop
{
    MicaController micaController;

    protected override void OnTargetConnected(ICompositionSupportsSystemBackdrop connectedTarget, XamlRoot xamlRoot)
    {
        // Call the base method to initialize the default configuration object.
        base.OnTargetConnected(connectedTarget, xamlRoot);

        // This example does not support sharing MicaSystemBackdrop instances.
        if (micaController is not null)
        {
            throw new Exception("This controller cannot be shared");
        }

        micaController = new MicaController();
        // Set configuration.
        SystemBackdropConfiguration defaultConfig = GetDefaultSystemBackdropConfiguration(connectedTarget, xamlRoot);
        micaController.SetSystemBackdropConfiguration(defaultConfig);
        // Add target.
        micaController.AddSystemBackdropTarget(connectedTarget);
    }

    protected override void OnTargetDisconnected(ICompositionSupportsSystemBackdrop disconnectedTarget)
    {
        base.OnTargetDisconnected(disconnectedTarget);

        micaController.RemoveSystemBackdropTarget(disconnectedTarget);
        micaController = null;
    }
}

備註

使用此類別來建立自定義系統基底。 您不會直接建立此類別， (記下受保護的建構函式) 。 而是將它子類別化，以新增您的自定義支援。 您也可以使用其中一個內建衍生類別 MicaBackdrop 和 DesktopAcrylicBackdrop。

一般而言，自定義材質會覆寫 OnTargetConnected 來建立及設定支援 ISystemBackdropController，這會管理用來填滿底板區域的 CompositionBrush 。 筆刷的最終圖元轉譯會受到下列影響：

• 透過 SystemBackdropConfiguration 設定的環境/原則
• 材質的外觀參數，透過 ISystemBackdropControllerWithTargets.StateActiveHighContrast//Fallback () 和類似 MicaController.KindBase/BaseAlt () 等一般屬性公開。

內建控制器 (MicaController 和 DesktopAcrylicController) 支援下列參數來自定義其外觀： FallbackColor、 LuminosityOpacity、 TintColor和 TintOpacity。 內建系統 (MicaBackdrop 和 DesktopAcrylicBackdrop) 不會公開 FallbackColor 或材料自定義屬性 (TintOpacity等) 。 相反地，它們依賴基礎 MicaController 和 DesktopAcrylicController的默認淺色/深色組態。 若要自定義這些屬性，請建立衍生自 SystemBackdrop 的自定義材質類別，並公開所需的屬性。

建構函式

SystemBackdrop()

初始化 SystemBackdrop 類別的新執行個體。

屬性

Dispatcher	一律會在 Windows 應用程式 SDK 應用程式中傳回null。 請改用 DispatcherQueue 。 (繼承來源 DependencyObject)
DispatcherQueue	DispatcherQueue取得與這個 物件相關聯的 。 DispatcherQueue表示即使程式代碼是由非 UI 線程起始，也可以存取 DependencyObject UI 線程上的 。 (繼承來源 DependencyObject)

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	傳回針對相依性屬性所建立的任何基底值，如果動畫未使用中，則會套用。 (繼承來源 DependencyObject)
GetDefaultSystemBackdropConfiguration(ICompositionSupportsSystemBackdrop, XamlRoot)	擷取可傳遞至ISystemBackdropControllerWithTargets.SetSystemBackdropConfiguration的默認SystemBackdropConfiguration物件。
GetValue(DependencyProperty)	從 DependencyObject 傳回相依性屬性的目前有效值。 (繼承來源 DependencyObject)
OnDefaultSystemBackdropConfigurationChanged(ICompositionSupportsSystemBackdrop, XamlRoot)	覆寫這個方法，以在變更傳 GetDefaultSystemBackdropConfiguration 回的物件時呼叫。 如果您使用自定義 SystemBackdropConfiguration，這會很有用。
OnTargetConnected(ICompositionSupportsSystemBackdrop, XamlRoot)	當這個物件附加至有效的容器時呼叫;例如，在上 Window.SystemBackdrop設定時。
OnTargetDisconnected(ICompositionSupportsSystemBackdrop)	從容器清除此物件時呼叫。
ReadLocalValue(DependencyProperty)	如果已設定本機值，則傳回相依性屬性的本機值。 (繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊通知函式，以接聽此 DependencyObject 實例上特定 DependencyProperty 的變更。 (繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)	在 DependencyObject 上設定相依性屬性的本機值。 (繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback 註冊的變更通知。 (繼承來源 DependencyObject)

另請參閱

• Mica 材質
• 壓克力材質