BackdropMaterial Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
-
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 ApplyToRootOrPageBackground
proprié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.
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 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 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 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). |
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour