Partager via


AcrylicBrush Classe

Définition

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
Attributs

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