BackdropMaterial Classe

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Classe d’assistance pour appliquer un matériau de fond à la racine du contenu XAML.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

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>

Héritage

DependencyObject

BackdropMaterial

Attributs

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Mica.

Les applications WinUI 3 Gallery et WinUI 2 Gallery incluent des exemples interactifs de la plupart des contrôles et fonctionnalités WinUI 3 et WinUI 2.

Si elles sont déjà installées, ouvrez-les en cliquant sur les liens suivants : WinUI 3 Gallery ou WinUI 2 Gallery.

Si elles ne sont pas installées, vous pouvez télécharger WinUI 3 Gallery et WinUI 2 Gallery à partir du Microsoft Store.

Vous pouvez également obtenir le code source des deux applications à partir de GitHub (utilisez la branche main pour WinUI 3 et la branche winui2 pour WinUI 2).

Remarques

Un matériau d’arrière-plan est un matériau créé à partir d’une source de pixels provenant d’une zone située derrière le contenu XAML.

La BackdropMaterial classe vous permet d’appliquer un matériau de fond, Mica, à la cible de composition de votre application. Il prend automatiquement en charge les modifications de thème, les versions de niveau inférieur et l’état de l’appareil, en définissant un pinceau XAML de couleur neutre si nécessaire.

Attention

Lorsque vous appliquez le matériau de arrière-plan, ne définissez pas également la propriété sur le Background contenu de l’interface utilisateur. L’arrière-plan doit être transparent afin que le matériau de l’arrière-plan s’affiche à travers.

Propriétés jointes XAML

BackdropMaterial est la classe de service hôte pour la ApplyToRootOrPageBackgroundpropriété jointe XAML.

Pour prendre en charge l’accès du processeur XAML aux propriétés jointes, ainsi que pour exposer des opérations get et set équivalentes au code, chaque propriété jointe XAML possède une paire de méthodes d’accesseur Get et Set. Une autre façon d’obtenir ou de définir la valeur dans le code consiste à utiliser le système de propriétés de dépendance, en appelant GetValue ou SetValue et en passant le champ identificateur comme identificateur de propriété de dépendance.

Propriété jointe

Description

ApplyToRootOrPageBackground

Applique le matériau de fond à la racine ou à l’arrière-plan du contenu XAML. Type : Bool Champ identificateur : ApplyToRootOrPageBackgroundProperty Méthodes accesseur : GetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control),SetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control,System.Boolean) La ApplyToRootOrPageBackground propriété est une valeur booléenne qui indique si le matériau de arrière-plan est appliqué.

Propriétés

ApplyToRootOrPageBackgroundProperty

Identifie la BackdropMaterial.ApplyToRootOrPageBackground propriété jointe XAML. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Propriétés attachées

ApplyToRootOrPageBackground

Applique le matériau de fond à la racine ou à l’arrière-plan du contenu XAML. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Méthodes

GetApplyToRootOrPageBackground(Control)	Obtient la valeur de la BackdropMaterial.ApplyToRootOrPageBackground propriété jointe XAML pour l’élément cible. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SetApplyToRootOrPageBackground(Control, Boolean)	Définit la valeur de la BackdropMaterial.ApplyToRootOrPageBackground propriété jointe XAML pour un élément cible. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Voir aussi

• Mica