Brush Klasse

Definition

Namespace:

Windows.UI.Xaml.Media

Definiert Objekte, die zum Zeichnen von Grafikobjekten verwendet werden. Klassen, die von Brush abgeleitet werden, beschreiben, wie der Bereich gezeichnet wird.

public ref class Brush : DependencyObject, IAnimationObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Brush : DependencyObject, IAnimationObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject, IAnimationObject

Public Class Brush
Inherits DependencyObject
Implements IAnimationObject

<object property="predefinedColorName"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scR,scG,scB"/>
- or -
<object property="sc#scA,scR,scG,scB"/>

Vererbung

Object Platform::Object IInspectable DependencyObject Brush

Abgeleitet

Windows.UI.Xaml.Media.GradientBrush

Windows.UI.Xaml.Media.SolidColorBrush

Windows.UI.Xaml.Media.TileBrush

Windows.UI.Xaml.Media.XamlCompositionBrushBase

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IAnimationObject

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Beispiele und weitere Erläuterungen zu den Konzepten für das Zeichnen der Benutzeroberfläche, die von Brush dargestellt werden, finden Sie unter Verwenden von Pinsel.

Pinsel als XAML-Ressourcen

Jeder Pinseltyp, der in XAML deklariert werden kann (SolidColorBrush, LinearGradientBrush, ImageBrush), soll als Ressource definiert werden, sodass Sie diesen Pinsel als Ressource in der gesamten App wiederverwenden können. Die XAML-Syntax, die für Pinseltypen angezeigt wird, eignet sich zum Definieren des Pinsels als Ressource. Wenn Sie einen Pinsel als Ressource deklarieren, benötigen Sie auch ein x:Key-Attribut , das Sie später verwenden, um auf diese Ressource aus anderen Benutzeroberflächendefinitionen zu verweisen. Weitere Informationen zu XAML-Ressourcen und zur Verwendung des x:Key-Attributs finden Sie unter ResourceDictionary- und XAML-Ressourcenverweise.

Der Vorteil der Deklarierung von Pinsel als Ressourcen besteht darin, dass die Anzahl von Laufzeitobjekten reduziert wird, die zum Erstellen einer Benutzeroberfläche erforderlich sind: Der Pinsel wird jetzt als gemeinsame Ressource freigegeben, die Werte für mehrere Teile des Objektdiagramms bereitstellt.

Wenn Sie sich die vorhandenen Steuerelementvorlagendefinitionen für Windows-Runtime XAML-Steuerelemente ansehen, sehen Sie, dass die Vorlagen Pinselressourcen umfassend verwenden. Viele dieser Ressourcen sind Systemressourcen, und sie verwenden die {ThemeResource}-Markuperweiterung für den Ressourcenverweis und nicht die {StaticResource}-Markuperweiterung. Weitere Informationen zur Verwendung von Systemressourcenpinsel in Ihrer eigenen Steuerelementvorlage XAML finden Sie unter XAML-Designressourcen.

Vom Pinsel abgeleitete Klassen

Brush ist die übergeordnete Klasse für mehrere abgeleitete Klassen, die entweder praktische Pinsel implementieren, die UI-Regionen zeichnen, oder es sich um Zwischenbasisklassen für solche Pinsel handelt:

• GradientBrush: Intermediate-Basisklasse für LinearGradientBrush.
• SolidColorBrush: Dies ist bei weitem der am häufigsten verwendete Pinsel.
• TileBrush: Mittlere Basisklasse für ImageBrush.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1809	17763	PopulatePropertyInfo
1809	17763	PopulatePropertyInfoOverride

Konstruktoren

Brush()

Stellt das Initialisierungsverhalten der Basisklasse für von Brush abgeleitete Klassen bereit.

Eigenschaften

Dispatcher	Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das DependencyObject im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
Opacity	Ruft den Deckkraftgrad eines Pinsels ab oder legt diese fest.
OpacityProperty	Gibt die Abhängigkeitseigenschaft Deckkraft an.
RelativeTransform	Ruft die auf den Pinsel über relative Koordinaten angewendete Transformation ab oder legt diese fest.
RelativeTransformProperty	Gibt die RelativeTransform-Abhängigkeitseigenschaft an.
Transform	Dient zum Abrufen oder Festlegen der auf den Pinsel angewendeten Transformation.
TransformProperty	Gibt die Eigenschaft "Abhängigkeit transformieren " an.

Methoden

ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft festgelegt wurde, was in Fällen gilt, 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)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definiert eine Eigenschaft, die animiert werden kann.
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Definiert beim Überschreiben in einer abgeleiteten Klasse eine Eigenschaft, die animiert werden kann.
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (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 registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde. (Geerbt von DependencyObject)

Weitere Informationen

• DependencyObject
• SolidColorBrush
• Color
• Colors
• Verwenden von Pinseln
• Image und ImageBrush
• ResourceDictionary- und XAML-Ressourcenreferenzen