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 ギャラリーします。

インストールされていない場合は、WinUI 3 ギャラリー と WinUI 2 ギャラリー を Microsoft Store からダウンロードできます。

GitHub から両方のソース コードを取得することもできます (WinUI 3 の メイン ブランチと WinUI 2 の winui2 ブランチを使用します)。

注釈

背景素材は、XAML コンテンツの背後にある領域から取得されたピクセルのソースから作成された 素材 です。

クラスを使用すると、Mica背景素材をアプリケーションのコンポジション ターゲットに適用できます。 必要に応じてニュートラルカラーの XAML ブラシを設定することで、テーマの変更、下位レベルのバージョン、デバイスの状態を自動的にサポートします。

注意

背景素材を適用する場合は、UI コンテンツの Background プロパティも設定しないでください。 背景素材が透け通るように背景を透明にする必要があります。

XAML 添付プロパティ

BackdropMaterial は、ApplyToRootOrPageBackgroundXAML 添付プロパティのホスト サービス クラスです。

アタッチされたプロパティへの XAML プロセッサ アクセスをサポートし、同等の 取得 を公開し、 操作 をコードに設定するために、各 XAML 添付プロパティには、Get アクセサー メソッドと Set アクセサー メソッドのペアがあります。 コードで値を取得または設定するもう 1 つの方法は、依存関係プロパティ システムを使用して、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