AcrylicBrush Classe

Référence

Définition

Espace de noms:: Windows.UI.Xaml.Media

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.

Modifier

Peint une zone avec un matériau semi-transparent qui utilise plusieurs effets, y compris le flou et une texture de bruit.

API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush (pour WinUI dans le kit de développement logiciel (SDK) d’application Windows , consultez les espaces de nomsdu SDK d’application Windows ).

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[WebHostHidden]
class AcrylicBrush : XamlCompositionBrushBase

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AcrylicBrush : XamlCompositionBrushBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class AcrylicBrush : XamlCompositionBrushBase

function AcrylicBrush()

Public Class AcrylicBrush
Inherits XamlCompositionBrushBase

Héritage: Object IInspectable DependencyObject Brush XamlCompositionBrushBase AcrylicBrush

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Fall Creators Update (introduit dans 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v5.0)

Exemples

Pourboire

Pour plus d’informations, des conseils de conception et des exemples de code, consultez matériau acrylique.

Si l’application galerie WinUI 2 est installée, cliquez ici pour ouvrir l’application et voir Acrylique en action.

Pour ajouter un pinceau acrylique, définissez les trois ressources pour les thèmes foncés, clairs et à contraste élevé. Notez qu’en contraste élevé, nous vous recommandons d’utiliser un SolidColorBrush avec la même x:Key que l’acrylique foncé/clair.

Note

Si vous ne spécifiez pas de valeur TintLuminosityOpacity, le système ajuste automatiquement sa valeur en fonction de votre TintColor et de TintOpacity.

<ResourceDictionary.ThemeDictionaries>
    <ResourceDictionary x:Key="Default">
        <AcrylicBrush x:Key="MyAcrylicBrush"
            BackgroundSource="HostBackdrop"
            TintColor="#FFFF0000"
            TintOpacity="0.8"
            TintLuminosityOpacity="0.5"
            FallbackColor="#FF7F0000"/>
    </ResourceDictionary>

    <ResourceDictionary x:Key="HighContrast">
        <SolidColorBrush x:Key="MyAcrylicBrush"
            Color="{ThemeResource SystemColorWindowColor}"/>
    </ResourceDictionary>

    <ResourceDictionary x:Key="Light">
        <AcrylicBrush x:Key="MyAcrylicBrush"
            BackgroundSource="HostBackdrop"
            TintColor="#FFFF0000"
            TintOpacity="0.8"
            TintLuminosityOpacity="0.5"
            FallbackColor="#FFFF7F7F"/>
    </ResourceDictionary>
</ResourceDictionary.ThemeDictionaries>

Cet exemple montre comment créer un acryliqueBrush dans le code. Si votre application prend en charge plusieurs cibles de système d’exploitation, veillez à vérifier que cette API est disponible sur l’ordinateur de l’utilisateur avant de l’utiliser.

if (Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.UI.Xaml.Media.AcrylicBrush"))
{
    Windows.UI.Xaml.Media.AcrylicBrush myBrush = new Windows.UI.Xaml.Media.AcrylicBrush();
    myBrush.BackgroundSource = Windows.UI.Xaml.Media.AcrylicBackgroundSource.HostBackdrop;
    myBrush.TintColor = Color.FromArgb(255, 202, 24, 37);
    myBrush.FallbackColor = Color.FromArgb(255, 202, 24, 37);
    myBrush.TintOpacity = 0.6;

    grid.Fill = myBrush;
}
else
{
    SolidColorBrush myBrush = new SolidColorBrush(Color.FromArgb(255, 202, 24, 37));

    grid.Fill = myBrush;
}

Remarques

Historique des versions

Version de Windows	Version du Kit de développement logiciel (SDK	Valeur ajoutée
1903	18362	TintLuminosityOpacity

Constructeurs

AcrylicBrush()

Initialise une nouvelle instance de la classe AcryliqueBrush.

API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.-ctor (pour WinUI dans le kit de développement logiciel (SDK) d’application Windows , consultez les espaces de noms sdk d’application Windows).

Propriétés

AlwaysUseFallback	Obtient ou définit une valeur qui spécifie si le pinceau est forcé à la couleur de secours unie. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.AlwaysUseFallback (pour WinUI dans lesdk d’application Windows , consultez les espaces de noms sdk d’application Windows).
AlwaysUseFallbackProperty	Identifie la propriété de dépendance AlwaysUseFallback. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.AlwaysUseFallbackProperty (pour WinUI dans le kit de développement logiciel (SDK) d’application Windows , consultez les espaces de noms sdk d’application Windows).
BackgroundSource	Obtient ou définit une valeur qui spécifie si les exemples de pinceau à partir du contenu de l’application ou du contenu derrière la fenêtre de l’application. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.BackgroundSource (pour WinUI dans lesdk d’application Windows , consultez les espaces de noms sdk d’application Windows).
BackgroundSourceProperty	Identifie la propriété de dépendance BackgroundSource. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.BackgroundSourceProperty (pour WinUI dans lesdk d’application Windows , consultez les espaces de nomsdu SDK d’application Windows ).
CompositionBrush	Obtient ou définit le compositionBrush utilisé par ce pinceau XAML. (Hérité de XamlCompositionBrushBase)
Dispatcher	Obtient le CoreDispatcher auquel cet objet est associé. Le CoreDispatcher représente une fonctionnalité qui peut accéder à la DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur. (Hérité de DependencyObject)
FallbackColor	Couleur à utiliser pour le rendu au cas où le CompositionBrush ne peut pas être rendu. (Hérité de XamlCompositionBrushBase)
Opacity	Obtient ou définit le degré d’opacité d’un Pinceau. (Hérité de Brush)
RelativeTransform	Obtient ou définit la transformation appliquée au pinceau à l’aide de coordonnées relatives. (Hérité de Brush)
TintColor	Obtient ou définit la teinte de couleur pour le matériau acrylique semi-transparent. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.TintColor (pour WinUI dans lesdk d’application Windows , consultez les espaces de nomsdu SDK d’application Windows ).
TintColorProperty	Identifie la propriété de dépendance TintColor. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.TintColorProperty (pour WinUI dans le sdk d’application Windows , consultez les espaces de noms sdk d’application Windows).
TintLuminosityOpacity	Obtient ou définit la quantité de luminosité entre la teintecolore et les pixels sous-jacents derrière la surface acrylique. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.TintLuminosityOpacity (pour WinUI dans lesdk d’application Windows , consultez les espaces de noms sdk d’application Windows).
TintLuminosityOpacityProperty	Identifie la propriété de dépendance TintLuminosityOpacity. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.TintLuminosityOpacityProperty (pour WinUI dans lesdk d’application Windows , consultez les espaces de nomsdu SDK d’application Windows ).
TintOpacity	Obtient ou définit le degré d’opacité de la teinte de couleur. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.TintOpacity (pour WinUI dans lesdk d’application Windows , consultez les espaces de noms sdk d’application Windows).
TintOpacityProperty	Identifie la propriété de dépendance TintOpacity. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.TintOpacityProperty (pour WinUI dans lesdk d’application Windows , consultez les espaces de nomsdu SDK d’application Windows ).
TintTransitionDuration	Obtient ou définit la longueur de l’animation de transition automatique utilisée lorsque TintColor change. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.TintTransitionDuration (pour WinUI dans le SDK d’application Windows, consultez les espaces de nomsdu SDK d’application Windows ).
TintTransitionDurationProperty	Identifie la propriété de dépendance TintTransitionDuration. API WinUI 2 équivalente pour UWP: Microsoft.UI.Xaml.Media.AcryliqueBrush.TintTransitionDurationPropertyProperty (pour WinUI dans lesdk d’application Windows , consultez les espaces de noms sdk d’application Windows).
Transform	Obtient ou définit la transformation appliquée au pinceau. (Hérité de Brush)

Méthodes

ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’une DependencyObject. (Hérité de DependencyObject)
OnConnected()	Appelé lorsqu’un pinceau est utilisé pour la première fois à l’écran pour peindre un élément. En cas d’implémentation dans une classe dérivée, vous pouvez créer une instance CompositionBrush et la fournir à l’infrastructure en définissant la propriété CompositionBrush. onDisconnected sera appelée lorsque le pinceau n’est plus utilisé pour peindre des éléments. (Hérité de XamlCompositionBrushBase)
OnDisconnected()	Appelé lorsque le pinceau n’est plus utilisé pour peindre des éléments. En cas d’implémentation dans une classe dérivée, vous pouvez supprimer en toute sécurité le pinceau de compostion et d’autres ressources de composition. onConnected sera appelée à nouveau si le pinceau est utilisé ultérieurement pour peindre des éléments après avoir été déconnectés. (Hérité de XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Définit une propriété qui peut être animée. (Hérité de Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	En cas de substitution dans une classe dérivée, définit une propriété qui peut être animée. (Hérité de Brush)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur cette instance DependencyObject. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject)

S’applique à

Voir aussi

vue d’ensemble des matériaux acryliques

Partage via