Brush Klasse

Referenz

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

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 von Grafikobjekten verwendet werden. Von Brush abgeleitete Klassen beschreiben, wie der Bereich gezeichnet wird.

public ref class Brush abstract : System::Windows::Media::Animation::Animatable, IFormattable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public abstract class Brush : System.Windows.Media.Animation.Animatable, IFormattable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Brush = class
    inherit Animatable
    interface IFormattable
    interface DUCE.IResource

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Brush = class
    inherit Animatable
    interface IFormattable

Public MustInherit Class Brush
Inherits Animatable
Implements IFormattable

Vererbung: Object

DispatcherObject

DependencyObject

Freezable

Animatable
Brush

Abgeleitet: System.Windows.Media.BitmapCacheBrush

System.Windows.Media.GradientBrush

System.Windows.Media.SolidColorBrush

System.Windows.Media.TileBrush

Attribute: TypeConverterAttribute LocalizabilityAttribute

Implementiert: IFormattable

Hinweise

Ein Brush "zeichnet" oder "füllt" einen Bereich mit seiner Ausgabe aus. Verschiedene Pinsel haben unterschiedliche Ausgabetypen. Einige Pinsel zeichnen einen Bereich mit einer Volltonfarbe, andere mit einem Farbverlauf, Muster, Bild oder Zeichnung. In der folgenden Liste werden die verschiedenen Typen von WPF-Pinsel beschrieben:

SolidColorBrush: Zeichnet einen Bereich mit einem Vollton Color.
LinearGradientBrush: Zeichnet einen Bereich mit einem linearen Farbverlauf.
RadialGradientBrush: Zeichnet einen Bereich mit einem radialen Farbverlauf.
ImageBrush: Zeichnet einen Bereich mit einem Bild (dargestellt durch ein ImageSource -Objekt).
DrawingBrush: Zeichnet einen Bereich mit einem Drawing. Die Zeichnung kann Vektor- und Bitmapobjekte enthalten.
VisualBrush: Zeichnet einen Bereich mit einem Visual -Objekt. Mit VisualBrush können Sie Inhalte aus einem Teil Ihrer Anwendung in einen anderen Bereich duplizieren. Es ist sehr nützlich, um Reflektionseffekte zu erstellen und Teile des Bildschirms zu vergrößern.

Vordefinierte Pinsel

Verwenden Sie die Brushes -Klasse, um ein Objekt mit einer vordefinierten Volltonfarbe wie oder AliceBlue Redzu zeichnen.

Pinsel in XAML

In der folgenden Tabelle sind die verschiedenen Brush Typen aufgeführt, die in XAML verwendet werden können, und die syntax, die sie unterstützen. Ausführliche Syntaxinformationen für einen bestimmten Pinsel finden Sie auf der Typseite dieses Pinsels.

Klasse	Attributsyntax	Objektelementsyntax
SolidColorBrush	Ja	Ja
DrawingBrush	Nein	Ja
ImageBrush	Nein	Ja
LinearGradientBrush	Nein	Ja
RadialGradientBrush	Nein	Ja
VisualBrush	Nein	Ja

Ein Beispiel für das schnelle Zeichnen eines Bereichs mit einer Volltonfarbe finden Sie unter Vorgehensweise: Zeichnen eines Bereichs mit einer Volltonfarbe.

Features von Freezable

Ein Pinsel ist ein Objekttyp Freezable . Informationen zu Freezable Features wie dem Einfrieren und Klonen finden Sie in der Übersicht über Freezable-Objekte.

XAML-Textverwendung

XAML-Informationen finden Sie im Abschnitt Hinweise .

Hinweise für Ausführende

Wenn Sie von der Brush -Klasse erben, müssen Sie die CreateInstanceCore() -Methode überschreiben. Je nachdem, ob Ihre Klasse zusätzliche Initialisierungsarbeiten ausführen muss oder Nicht-Abhängigkeitseigenschaftsdatenmember enthält, müssen Sie möglicherweise zusätzliche Freezable Methoden überschreiben. Weitere Informationen zum Erben von Freezable Typen finden Sie in der Übersicht über Freezable-Objekte.

Konstruktoren

Brush()

Initialisiert eine neue Instanz der Brush-Klasse.

Felder

OpacityProperty	Bezeichnet die Opacity-Abhängigkeitseigenschaft.
RelativeTransformProperty	Bezeichnet die RelativeTransform-Abhängigkeitseigenschaft.
TransformProperty	Bezeichnet die Transform-Abhängigkeitseigenschaft.

Eigenschaften

CanFreeze	Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann. (Geerbt von Freezable)
DependencyObjectType	Ruft den ab, der DependencyObjectType den CLR-Typ dieses instance umschließt. (Geerbt von DependencyObject)
Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
HasAnimatedProperties	Ruft einen Wert ab, der angibt, ob einer der Abhängigkeitseigenschaften dieses Objekts ein oder mehrere AnimationClock-Objekte zugeordnet sind. (Geerbt von Animatable)
IsFrozen	Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann. (Geerbt von Freezable)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Geerbt von DependencyObject)
Opacity	Ruft den Grad der Deckkraft eines Brush ab oder legt ihn fest.
RelativeTransform	Ruft die auf den Pinsel über relative Koordinaten angewendete Transformation ab oder legt diese fest.
Transform	Dient zum Abrufen oder Festlegen der auf den Pinsel angewendeten Transformation. Diese Transformation wird angewendet, nachdem die Ausgabe des Pinsels zugeordnet und positioniert wurde.

Methoden

ApplyAnimationClock(DependencyProperty, AnimationClock)	Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Geerbt von Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Geerbt von Animatable)
CheckAccess()	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. (Geerbt von DependencyObject)
Clone()	Erstellt einen änderbaren Klon dieser Brush, indem tiefe Kopien der Werte dieses Objekts erzeugt werden. Beim Kopieren von Abhängigkeitseigenschaften kopiert diese Methode Ressourcenverweise und Datenbindungen (die aber möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte.
CloneCore(Freezable)	Definiert die Instanz als Klon (tiefe Kopie) des angegebenen Freezable-Elements, indem Basiseigenschaftenwerte (nicht animiert) verwendet werden. (Geerbt von Freezable)
CloneCurrentValue()	Erstellt einen änderbaren Klon des Brush-Objekts, indem tiefe Kopien der aktuellen Werte dieses Objekts erzeugt werden. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert.
CloneCurrentValueCore(Freezable)	Macht die Instanz mithilfe aktueller Eigenschaftswerte zu einem Klon (tiefe Kopie) des angegebenen Freezable-Elements, der geändert werden kann. (Geerbt von Freezable)
CoerceValue(DependencyProperty)	Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird. (Geerbt von DependencyObject)
CreateInstance()	Initialisiert eine neue Instanz der Freezable-Klasse. (Geerbt von Freezable)
CreateInstanceCore()	Erstellt beim Implementieren in einer abgeleiteten Klasse eine neue Instanz der abgeleiteten Freezable-Klasse. (Geerbt von Freezable)
Equals(Object)	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Geerbt von DependencyObject)
Freeze()	Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf `true` fest. (Geerbt von Freezable)
FreezeCore(Boolean)	Legt dieses Animatable-Objekt als nicht änderbar fest oder bestimmt, ob es als nicht änderbar festgelegt werden kann. (Geerbt von Animatable)
GetAnimationBaseValue(DependencyProperty)	Gibt den nicht animierten Wert der angegebenen DependencyProperty zurück. (Geerbt von Animatable)
GetAsFrozen()	Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Geerbt von Freezable)
GetAsFrozenCore(Freezable)	Definiert die Instanz als fixierten Klon des angegebenen Freezable-Elements, indem Basiseigenschaftenwerte (nicht animiert) verwendet werden. (Geerbt von Freezable)
GetCurrentValueAsFrozen()	Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Geerbt von Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Macht diese aktuelle Instanz zu einem fixierten Klon des angegebenen Freezable-Objekts. Wenn das Objekt über animierte Abhängigkeitseigenschaften verfügt, werden die aktuellen animierten Werte kopiert. (Geerbt von Freezable)
GetHashCode()	Ruft einen Hashcode für diese DependencyObject ab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Geerbt von DependencyObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück. (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnChanged()	Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Dieses Member unterstützt die Windows Presentation Foundation -Infrastruktur (WPF) und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Überschreibt die DependencyObject-Implementierung von OnPropertyChanged(DependencyPropertyChangedEventArgs), damit in Reaktion auf eine geänderte Abhängigkeitseigenschaft des Typs Freezable auch Changed-Handler aufgerufen werden. (Geerbt von Freezable)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist. (Geerbt von DependencyObject)
ReadPreamble()	Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird. Vererber von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Geerbt von Freezable)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt eine Zeichenfolgendarstellung für diesen Brush zurück.
ToString(IFormatProvider)	Erstellt eine Zeichenfolgendarstellung dieses Objekts anhand der angegebenen kulturspezifischen Formatierungsinformationen.
VerifyAccess()	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
WritePostscript()	Löst das Changed-Ereignis für das Freezable-Objekt aus und ruft dessen OnChanged()-Methode auf. Klassen, die aus Freezable abgeleitet werden, sollten diese Methode am Ende jeder API aufrufen, die Klassenmember ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind. (Geerbt von Freezable)
WritePreamble()	Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird. Vererber von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Geerbt von Freezable)

Ereignisse

Changed

Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird.

(Geerbt von Freezable)

Explizite Schnittstellenimplementierungen

IFormattable.ToString(String, IFormatProvider)

Formatiert den Wert der aktuellen Instanz mit dem angegebenen Format.

Gilt für:

Freigeben über