Condividi tramite


AcrylicBrush Classe

Definizione

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)]
[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
Ereditarietà
Attributi

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.

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)

Si applica a

Vedi anche