AcrylicBrush Classe

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Media

Disegna un'area con un materiale semitrasparente che utilizza più effetti, tra cui sfocatura e trama del rumore.

API WinUI 2 equivalente perUWP: Microsoft.UI.Xaml.Media.AcrylicBrush (per WinUI nel Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).

/// [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

Ereditarietà

Object IInspectable DependencyObject Brush XamlCompositionBrushBase AcrylicBrush

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 Fall Creators Update (è stato introdotto in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v5.0)

Esempio

Mancia

Per altre info, indicazioni sulla progettazione ed esempi di codice, vedi materiale acrilico.

Se è installata l'app raccolta winUI 2 , fare clic qui per aprire l'app e vedere Acrilico in azione.

• Ottenere l'app della raccolta WinUI 2 (Microsoft Store)
• Ottenere il codice sorgente (GitHub)

Per aggiungere un pennello acrilico, definire le tre risorse per i temi scuro, chiaro e a contrasto elevato. Si noti che, a contrasto elevato, è consigliabile usare solidColorBrush con lo stesso x:Key dell'acrilico scuro/chiaro.

Nota

Se non specifichi un valore TintLuminosityOpacity, il sistema regola automaticamente il valore in base a TintColor e 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>

Questo esempio illustra come creare un oggetto AcrylicBrush nel codice. Se l'app supporta più destinazioni del sistema operativo, assicurarsi di verificare che questa API sia disponibile nel computer dell'utente prima di usarla.

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;
}

Commenti

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1903	18362	TintLuminosityOpacity

Costruttori

AcrylicBrush()

Inizializza una nuova istanza della classe AcrylicBrush. API WinUI 2 equivalente perUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.-ctor (per WinUI nel Windows App SDK, vedere gli spazi dei nomi Windows App SDK).

Proprietà

AlwaysUseFallback	Ottiene o imposta un valore che specifica se il pennello viene forzato al colore di fallback a tinta unita. EQUIVALENTE API WinUI 2 perUWP: gli spazi dei nomi di Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFall back (per WinUI nel Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).
AlwaysUseFallbackProperty	Identifica la proprietà di dipendenza AlwaysUseFallback. API WinUI 2 equivalente perUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallbackProperty (per WinUI nel Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).
BackgroundSource	Ottiene o imposta un valore che specifica se i campioni di pennello dal contenuto dell'app o dal contenuto sottostante la finestra dell'app. Equivalente API WinUI 2 perUWP: microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSource (per WinUI nel Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).
BackgroundSourceProperty	Identifica la proprietà di dipendenza BackgroundSource. API WinUI 2 equivalente perUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSourceProperty (per WinUI nel Windows App SDK, vedere gli spazi dei nomidi Windows App SDK ).
CompositionBrush	Ottiene o imposta il CompositionBrush utilizzato da questo pennello XAML. (Ereditato da XamlCompositionBrushBase)
Dispatcher	Ottiene il CoreDispatcher a cui è associato questo oggetto. Il CoreDispatcher rappresenta una funzionalità che può accedere al DependencyObject nel thread dell'interfaccia utente anche se il codice viene avviato da un thread non dell'interfaccia utente. (Ereditato da DependencyObject)
FallbackColor	Colore da usare per il rendering nel caso in cui non sia possibile eseguire il rendering del CompositionBrush . (Ereditato da XamlCompositionBrushBase)
Opacity	Ottiene o imposta il grado di opacità di un Brush. (Ereditato da Brush)
RelativeTransform	Ottiene o imposta la trasformazione applicata al pennello utilizzando coordinate relative. (Ereditato da Brush)
TintColor	Ottiene o imposta la tinta di colore per il materiale acrilico semitrasparente. API WinUI 2 equivalente perUWP : Microsoft.UI.Xaml.Media.AcrylicBrush.TintColor (per WinUI nel Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).
TintColorProperty	Identifica la proprietà di dipendenza TintColor. API WinUI 2 equivalente perUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintColorProperty (per WinUI nel Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).
TintLuminosityOpacity	Ottiene o imposta la quantità di luminosità tra TintColor e i pixel sottostanti dietro la superficie acrilica. API WinUI 2 equivalente perUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacity (per WinUI nel Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).
TintLuminosityOpacityProperty	Identifica il TintLuminosityOpacity proprietà di dipendenza. API WinUI 2 equivalente perUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacityProperty (per WinUI nel Windows App SDK, vedere gli spazi dei nomidi Windows App SDK ).
TintOpacity	Ottiene o imposta il grado di opacità della tinta di colore. API WinUI 2 equivalente perUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacity (per WinUI nel windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).
TintOpacityProperty	Identifica la proprietà di dipendenza TintOpacity. API WinUI 2 equivalente perUWP : Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacityProperty (per WinUI nel Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).
TintTransitionDuration	Ottiene o imposta la lunghezza dell'animazione di transizione automatica utilizzata quando tintColor cambia. API WinUI 2 equivalente perUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDuration (per WinUI nel Windows App SDK, vedere gli spazi dei nomidi Windows App SDK ).
TintTransitionDurationProperty	Identifica la proprietà di dipendenza TintTransitionDuration. API WinUI 2 equivalente perUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDurationProperty (per WinUI nel Windows App SDK, vedere gli spazi dei nomi Windows App SDK).
Transform	Ottiene o imposta la trasformazione applicata al pennello. (Ereditato da Brush)

Metodi

ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva. (Ereditato da DependencyObject)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza da un DependencyObject. (Ereditato da DependencyObject)
OnConnected()	Richiamato quando un pennello viene utilizzato per la prima volta sullo schermo per disegnare un elemento. Quando implementato in una classe derivata, è possibile creare un'istanza CompositionBrush e specificarla nel framework impostando la proprietà compositionBrush . OnDisconnected verrà chiamato quando il pennello non viene più utilizzato per disegnare elementi. (Ereditato da XamlCompositionBrushBase)
OnDisconnected()	Richiamato quando il pennello non viene più utilizzato per disegnare alcun elemento. Se implementato in una classe derivata, è possibile eliminare in modo sicuro il pennello di compostione e altre risorse di composizione. OnConnected verrà chiamato di nuovo se il pennello viene usato successivamente per disegnare gli elementi dopo la disconnessione. (Ereditato da XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definisce una proprietà che può essere animata. (Ereditato da Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Quando sottoposto a override in una classe derivata, definisce una proprietà che può essere animata. (Ereditato da Brush)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se è impostato un valore locale. (Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una funzione di notifica per l'ascolto delle modifiche apportate a una specifica DependencyProperty in questa istanza DependencyObject. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza in un DependencyObject. (Ereditato da DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject)

Vedi anche

• panoramica materiale acrilico