Partager via


BackdropMaterial Classe

Définition

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

Cette documentation s’applique à WinUI 2 pour les UWP (pour WinUI dans lesdk d’application Windows , consultez les espaces de nomsdu 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
BackdropMaterial
Attributs
Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

Pourboire

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

La galerie WinUI 3 et galerie WinUI 2 les applications incluent des exemples interactifs de la plupart des contrôles, fonctionnalités et fonctionnalités WinUI 3 et WinUI 2.

Si elle est déjà installée, ouvrez-les en cliquant sur les liens suivants : galerie WinUI 3 ou galerie WinUI 2.

S’ils ne sont pas installés, vous pouvez télécharger le de la galerie WinUI 3 et la galerie WinUI 2 à partir du Microsoft Store.

Vous pouvez également obtenir le code source de GitHub (utilisez la branche principale pour WinUI 3 et la branche winui2 pour WinUI 2).

Remarques

Un matériau de fond est une Material créée à partir d’une source de pixels extraite d’une zone derrière le contenu XAML.

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

Prudence

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

Propriétés jointes XAML

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

Pour prendre en charge l’accès au processeur XAML aux propriétés jointes, ainsi que pour exposer des équivalents obtenir et définir des opérations de sur du code, chaque propriété jointe XAML a 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 d’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. La propriété ApplyToRootOrPageBackground est une valeur booléenne qui indique si le matériau de fond est appliqué.

Propriétés

ApplyToRootOrPageBackgroundProperty

Identifie la propriété jointe XAML BackdropMaterial.ApplyToRootOrPageBackground.

Cette documentation s’applique à WinUI 2 pour les UWP (pour WinUI dans lesdk d’application Windows , consultez les espaces de nomsdu 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 les UWP (pour WinUI dans lesdk d’application Windows , consultez les espaces de nomsdu SDK d’application Windows ).

Méthodes

GetApplyToRootOrPageBackground(Control)

Obtient la valeur de la propriété jointe XAML BackdropMaterial.ApplyToRootOrPageBackground pour l’élément cible.

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

SetApplyToRootOrPageBackground(Control, Boolean)

Définit la valeur de la propriété jointe XAML BackdropMaterial.ApplyToRootOrPageBackground pour un élément cible.

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

S’applique à

Voir aussi

  • Mica