BackdropMaterial 類別

定義

命名空間:

Microsoft.UI.Xaml.Controls

協助程式類別，將基底材質套用至 XAML 內容的根目錄。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱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 的主要 分支，以及 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 是布林值，指出是否套用底板材質。

屬性

ApplyToRootOrPageBackgroundProperty

BackdropMaterial.ApplyToRootOrPageBackground識別 XAML 附加屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

附加屬性

ApplyToRootOrPageBackground

將背景材質套用至 XAML 內容的根或背景。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

方法

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

另請參閱

• 雲母