AcrylicBrush Klasse

Referenz

Definition

Namespace:: Windows.UI.Xaml.Media

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Zeichnet einen Bereich mit einem semitransparenten Material, das mehrere Effekte verwendet, einschließlich Weichzeichner und einer Rauschtextur.

Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).

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

Vererbung: Object IInspectable DependencyObject Brush XamlCompositionBrushBase AcrylicBrush

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v5.0)

Beispiele

Trinkgeld

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Acrylmaterial.

Wenn Sie die WinUI 2 Gallery App installiert haben, klicken Sie hier, um die App zu zu öffnen und Acryl in Aktionanzuzeigen.

Um einen Acrylpinsel hinzuzufügen, definieren Sie die drei Ressourcen für dunkle Designs, helle und kontrastreiche Designs. Beachten Sie, dass bei hohem Kontrast die Verwendung eines SolidColorBrush mit demselben x:Key wie der dunkle/helle AcrylBrush empfohlen wird.

Anmerkung

Wenn Sie keinen TintLuminosityOpacity-Wert angeben, passt das System seinen Wert automatisch basierend auf Ihrem TintColor- und TintOpacity-Wert an.

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

In diesem Beispiel wird gezeigt, wie Ein AcrylBrush im Code erstellt wird. Wenn Ihre App mehrere Betriebssystemziele unterstützt, stellen Sie sicher, dass diese API auf dem Computer des Benutzers verfügbar ist, bevor Sie sie verwenden.

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

Hinweise

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1903	18362	TintLuminosityOpacity

Konstruktoren

AcrylicBrush()

Initialisiert eine neue Instanz der AcrylBrush-Klasse.

Gleichwertige WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.-ctor (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).

Eigenschaften

AlwaysUseFallback	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Pinsel zur einfarbigen Fallbackfarbe gezwungen wird. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.AlwaysUseFallback (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
AlwaysUseFallbackProperty	Identifies the AlwaysUseFallback dependency property. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.AlwaysUseFallbackProperty (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
BackgroundSource	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Pinselbeispiele aus dem App-Inhalt oder aus dem Inhalt hinter dem App-Fenster angegeben werden. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.BackgroundSource (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
BackgroundSourceProperty	Identifies the BackgroundSource dependency property. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.BackgroundSourceProperty (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
CompositionBrush	Ruft den CompositionBrush- ab, der von diesem XAML-Pinsel verwendet wird, oder legt diesen fest. (Geerbt von XamlCompositionBrushBase)
Dispatcher	Ruft den CoreDispatcher- ab, dem dieses Objekt zugeordnet ist. Die CoreDispatcher- stellt eine Einrichtung dar, die auf das DependencyObject- im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
FallbackColor	Die farbe, die für das Rendern verwendet werden soll, falls die CompositionBrush- nicht gerendert werden kann. (Geerbt von XamlCompositionBrushBase)
Opacity	Ruft den Grad der Deckkraft eines Brush-ab oder legt diese fest. (Geerbt von Brush)
RelativeTransform	Dient zum Abrufen oder Festlegen der Transformation, die mit relativen Koordinaten auf den Pinsel angewendet wird. (Geerbt von Brush)
TintColor	Dient zum Abrufen oder Festlegen des Farbtons für das halbtransparente Acrylmaterial. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.TintColor (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
TintColorProperty	Identifies the TintColor dependency property. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.TintColorProperty (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
TintLuminosityOpacity	Ruft die Helligkeitsmenge zwischen der TintColor und den zugrunde liegenden Pixeln hinter der Acryloberfläche ab oder legt sie fest. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.TintLuminosityOpacity (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
TintLuminosityOpacityProperty	Identifies the TintLuminosityOpacity dependency property. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.TintLuminosityOpacityProperty (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
TintOpacity	Dient zum Abrufen oder Festlegen des Grads der Deckkraft des Farbtons. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.TintOpacity (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
TintOpacityProperty	Identifies the TintOpacity dependency property. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.TintOpacityProperty (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
TintTransitionDuration	Ruft die Länge der automatischen Übergangsanimation ab, die beim Ändern der TintColor verwendet wird, oder legt sie fest. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.TintTransitionDuration (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
TintTransitionDurationProperty	Identifies the TintTransitionDuration dependency property. Entsprechung WinUI 2-API für UWP-: Microsoft.UI.Xaml.Media.AcrylBrush.TintTransitionDurationProperty (für WinUI im Windows App SDKfinden Sie unter den Windows App SDK-Namespaces).
Transform	Dient zum Abrufen oder Festlegen der Transformation, die auf den Pinsel angewendet wird. (Geerbt von Brush)

Methoden

ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Gibt einen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject-zurück. (Geerbt von DependencyObject)
OnConnected()	Wird aufgerufen, wenn ein Pinsel zum ersten Mal auf dem Bildschirm zum Zeichnen eines Elements verwendet wird. Bei der Implementierung in einer abgeleiteten Klasse können Sie eine CompositionBrush- Instanz erstellen und dem Framework bereitstellen, indem Sie die CompositionBrush-Eigenschaft festlegen. OnDisconnected- wird aufgerufen, wenn der Pinsel nicht mehr zum Zeichnen von Elementen verwendet wird. (Geerbt von XamlCompositionBrushBase)
OnDisconnected()	Wird aufgerufen, wenn der Pinsel nicht mehr zum Zeichnen von Elementen verwendet wird. Bei der Implementierung in einer abgeleiteten Klasse können Sie die Kompostierungsbürste und andere Kompositionsressourcen sicher verwerfen. OnConnected wird erneut aufgerufen, wenn der Pinsel später zum Zeichnen von Elementen verwendet wird, nachdem die Verbindung getrennt wurde. (Geerbt von XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definiert eine Eigenschaft, die animiert werden kann. (Geerbt von Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Wenn eine abgeleitete Klasse überschrieben wird, wird eine Eigenschaft definiert, die animiert werden kann. (Geerbt von Brush)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt wird. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty- für diese DependencyObject-Instanz zu überwachen. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject-fest. (Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen RegisterPropertyChangedCallback-registriert wurde. (Geerbt von DependencyObject)

Gilt für:

Weitere Informationen

übersicht über Acrylmaterial

Freigeben über