BackdropMaterial クラス

リファレンス

定義

名前空間:: Microsoft.UI.Xaml.Controls

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

XAML コンテンツのルートに背景素材を適用するヘルパークラス。

このドキュメントは、UWP 用の WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、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

例

ヒント

詳細、設計ガイダンス、およびコード例については、「マイカ」を参照してください。

WinUI 3 ギャラリー アプリと WinUI 2 ギャラリー アプリには、ほとんどの WinUI 3 および WinUI 2 コントロールと機能の対話型の例が含まれています。

既にインストールされている場合は、WinUI 3 ギャラリーまたは WinUI 2 ギャラリーのリンクをクリックして開きます。

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

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

注釈

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

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

注意事項

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

XAML 添付プロパティ

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

アタッチされたプロパティへの XAML プロセッサアクセスをサポートし、同等の get 操作と set 操作をコードに公開するために、各 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` 、背景素材が適用されているかどうかを示すブール値です。

ApplyToRootOrPageBackground

XAML コンテンツのルートまたは背景に背景素材を適用します。