Brush Klasse
Definition
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.
Definiert Objekte, die zum Zeichnen grafischer Objekte verwendet werden. Klassen, die von Brush abgeleitet werden, beschreiben, wie der Bereich gezeichnet wird.
public ref class Brush : DependencyObject, IAnimationObject/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject, IAnimationObjectPublic 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
- Abgeleitet
- Attribute
- Implementiert
Hinweise
Beispiele und weitere Erläuterungen der ui-Zeichnungskonzepte, die von Brush dargestellt werden, finden Sie unter XAML-Pinsel.
Pinsel als XAML-Ressourcen
Die Pinseltypen, die in XAML deklariert werden können (z. B . SolidColorBrush, LinearGradientBrush und ImageBrush), sollen als Ressource definiert werden, damit sie in der gesamten App problemlos wiederverwendet werden können. Die für Pinseltypen gezeigte XAML-Syntax 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 werden, um aus anderen UI-Definitionen auf diese Ressource 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 der Laufzeitobjekte 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 verwenden die {ThemeResource}-Markuperweiterung für den Ressourcenverweis anstelle der {StaticResource}-Markuperweiterung. Weitere Informationen zur Verwendung von Systemressourcenpinseln in Ihrer eigenen Steuerelementvorlagen-XAML finden Sie unter XAML-Designressourcen.
Vom Pinsel abgeleitete Klassen
Brush ist die übergeordnete Klasse für mehrere abgeleitete Klassen, die praktische Pinsel implementieren, die UI-Bereiche zeichnen oder Zwischenklassen für solche Pinsel sind:
- GradientBrush: Zwischenbasisklasse für LinearGradientBrush.
- SolidColorBrush: Dies ist bei weitem der am häufigsten verwendete Pinsel.
- TileBrush: Zwischenbasisklasse für ImageBrush.
Konstruktoren
| Name | Beschreibung |
|---|---|
| Brush() |
Stellt das Basisklasseninitialisierungsverhalten für vom Pinsel abgeleitete Klassen bereit. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
| DispatcherQueue |
Ruft ab |
| Opacity |
Dient zum Abrufen oder Festlegen des Grads der Deckkraft eines Pinsels. |
| OpacityProperty |
Identifies the Opacity dependency property. |
| RelativeTransform |
Dient zum Abrufen oder Festlegen der Transformation, die mit relativen Koordinaten auf den Pinsel angewendet wird. |
| RelativeTransformProperty |
Identifies the RelativeTransform dependency property. |
| Transform |
Dient zum Abrufen oder Festlegen der Transformation, die auf den Pinsel angewendet wird. |
| TransformProperty |
Identifies the Transform dependency property. |
Methoden
| Name | Beschreibung |
|---|---|
| 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) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Definiert eine Eigenschaft, die animiert werden kann. |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
Wenn eine abgeleitete Klasse überschrieben wird, wird eine Eigenschaft definiert, die animiert werden kann. |
| 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 von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject) |