BackdropMaterial 類別

定義

命名空間:

Microsoft.UI.Xaml.Controls

協助程序類別，將背景材質套用至 XAML 內容的根目錄。

本檔適用於適用於UWP 的 WinUI 2 （適用於 Windows App SDK中的 WinUI ，請參閱 Windows App 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 使用 main 分支，以及適用於 WinUI 2 的 winui2 分支）。

備註

背景材質是 材質 從 XAML 內容後方區域擷取的圖元來源所建立。

BackdropMaterial 類別可讓您將背景材質 mica套用至應用程式的撰寫目標。 它可視需要設定中性色彩的 XAML 筆刷，自動支援主題變更、下層版本和裝置狀態。

謹慎

當您套用背景材質時，請勿在UI內容上設定 Background 屬性。 背景必須透明，背景材質才會顯示。

XAML 附加屬性

BackdropMaterial 是 ApplyToRootOrPageBackgroundXAML 附加屬性的主機服務類別。

為了支援 XAML 處理器存取附加屬性，而且為了公開對等 取得，並將 設定為程式代碼 作業，每個 XAML 附加屬性都有一對 Get 和 Set 存取子方法。 在程序代碼中取得或設定值的另一種方法是使用相依性屬性系統，呼叫 GetValue 或 SetValue，並將標識符欄位傳遞為相依性屬性標識符。

附加屬性	描述
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 App SDK中的 WinUI ，請參閱 Windows App SDK 命名空間]。

附加屬性

ApplyToRootOrPageBackground

將背景材質套用至 XAML 內容的根或背景。 本檔適用於適用於UWP 的 WinUI 2 （適用於 Windows App SDK中的 WinUI ，請參閱 Windows App SDK 命名空間]。

方法

GetApplyToRootOrPageBackground(Control)	取得目標專案 BackdropMaterial.ApplyToRootOrPageBackground XAML 附加屬性的值。 本檔適用於適用於UWP 的 WinUI 2 （適用於 Windows App SDK中的 WinUI ，請參閱 Windows App SDK 命名空間]。
SetApplyToRootOrPageBackground(Control, Boolean)	設定目標元素 BackdropMaterial.ApplyToRootOrPageBackground XAML 附加屬性的值。 本檔適用於適用於UWP 的 WinUI 2 （適用於 Windows App SDK中的 WinUI ，請參閱 Windows App SDK 命名空間]。

另請參閱

• Mica