Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
Brush-Klasse
Definiert Objekte, die zum Zeichnen grafischer Objekte verwendet werden. Von Brush abgeleitete Klassen beschreiben, wie der Bereich gezeichnet wird.
System.Windows.Threading.DispatcherObject
System.Windows.DependencyObject
System.Windows.Freezable
System.Windows.Media.Animation.Animatable
System.Windows.Media.Brush
System.Windows.Media.BitmapCacheBrush
System.Windows.Media.GradientBrush
System.Windows.Media.SolidColorBrush
System.Windows.Media.TileBrush
Assembly: PresentationCore (in PresentationCore.dll)
XMLNS für XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
Der Brush-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
CanFreeze | Ruft einen Wert ab, der angibt, ob das Objekt als nicht änderbar festgelegt werden kann. (Von Freezable geerbt.) |
|
|
DependencyObjectType | Ruft den DependencyObjectType ab, der den CLR-Typ dieser Instanz umschließt. (Von DependencyObject geerbt.) |
|
|
Dispatcher | Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Von DispatcherObject geerbt.) |
|
|
HasAnimatedProperties | Ruft einen Wert ab, der angibt, ob einer der Abhängigkeitseigenschaften dieses Objekts ein oder mehrere AnimationClock-Objekte zugeordnet sind. (Von Animatable geerbt.) |
|
|
IsFrozen | Ruft einen Wert ab, der angibt, ob das Objekt gegenwärtig änderbar ist. (Von Freezable geerbt.) |
|
|
IsSealed | Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Von DependencyObject geerbt.) |
|
|
Opacity | Ruft die Durchlässigkeit eines Brush ab oder legt diese fest. |
|
|
RelativeTransform | Ruft die Transformation ab, die mit relativen Koordinaten auf den Pinsel angewendet wird, oder legt diese fest. |
|
|
Transform | Ruft die auf den Pinsel angewendete Transformation ab oder legt diese fest. Diese Transformation wird angewendet, nachdem die Ausgabe des Pinsels zugeordnet und positioniert wurde. |
| Name | Beschreibung | |
|---|---|---|
|
ApplyAnimationClock(DependencyProperty, AnimationClock) | Wendet eine AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Von Animatable geerbt.) |
|
|
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) | Wendet eine AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Von Animatable geerbt.) |
|
|
BeginAnimation(DependencyProperty, AnimationTimeline) | Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn das nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Von Animatable geerbt.) |
|
|
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) | Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn das nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Von Animatable geerbt.) |
|
|
CheckAccess | Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.) |
|
|
ClearValue(DependencyProperty) | Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyProperty-Bezeichner angegeben. (Von DependencyObject geerbt.) |
|
|
ClearValue(DependencyPropertyKey) | Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyPropertyKey angegeben. (Von DependencyObject geerbt.) |
|
|
Clone | Erstellt einen änderbaren Klon des Brush, indem tiefe Kopien von den Werten dieses Objekts erzeugt werden. Beim Kopieren von Abhängigkeitseigenschaften kopiert diese Methode Ressourcenverweise und Datenbindungen (die jedoch möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte. |
|
CloneCore | Definiert die Instanz als Klon (tiefe Kopie) des angegebenen Freezable mit Basiseigenschaftswerten (nicht animiert). (Von Freezable geerbt.) |
|
|
CloneCurrentValue | Erstellt einen änderbaren Klon des Brush-Objekts, indem tiefe Kopien von den aktuellen Werten dieses Objekts erzeugt werden. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert. |
|
|
CloneCurrentValueCore | Definiert die Instanz mit aktuellen Eigenschaftswerten als änderbaren Klon (tiefe Kopie) des angegebenen Freezable. (Von Freezable geerbt.) |
|
|
CoerceValue | Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Für die Umwandlung wird eine vorhandene CoerceValueCallback-Funktion aufgerufen, die in den Metadaten der Abhängigkeitseigenschaft für das aufrufende DependencyObject angegeben ist. (Von DependencyObject geerbt.) |
|
|
CreateInstance | Initialisiert eine neue Instanz der Freezable-Klasse. (Von Freezable geerbt.) |
|
|
CreateInstanceCore | Erstellt beim Implementieren in einer abgeleiteten Klasse eine neue Instanz der abgeleiteten Freezable-Klasse. (Von Freezable geerbt.) |
|
|
Equals | Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Von DependencyObject geerbt.) |
|
|
Finalize | Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.) |
|
|
Freeze() | Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf true fest. (Von Freezable geerbt.) |
|
|
FreezeCore | Legt dieses Animatable-Objekt als nicht änderbar fest oder bestimmt, ob es als nicht änderbar festgelegt werden kann. (Von Animatable geerbt.) |
|
|
GetAnimationBaseValue | Gibt den nicht animierten Wert der angegebenen DependencyProperty zurück. (Von Animatable geerbt.) |
|
|
GetAsFrozen | Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Von Freezable geerbt.) |
|
|
GetAsFrozenCore | Definiert die Instanz als fixierten Klon des angegebenen Freezable mit Basiseigenschaftswerten (nicht animiert). (Von Freezable geerbt.) |
|
|
GetCurrentValueAsFrozen | Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Von Freezable geerbt.) |
|
|
GetCurrentValueAsFrozenCore | Legt die aktuelle Instanz als fixierten Klon des angegebenen Freezable fest. Wenn das Objekt über animierte Abhängigkeitseigenschaften verfügt, werden die aktuellen animierten Werte kopiert. (Von Freezable geerbt.) |
|
|
GetHashCode | Ruft einen Hashcode für dieses DependencyObject ab. (Von DependencyObject geerbt.) |
|
|
GetLocalValueEnumerator | Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Von DependencyObject geerbt.) |
|
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
|
GetValue | Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft in dieser Instanz eines DependencyObject zurück. (Von DependencyObject geerbt.) |
|
|
InvalidateProperty | Berechnet den effektiven Wert für die angegebene Abhängigkeitseigenschaft neu (Von DependencyObject geerbt.) |
|
|
MemberwiseClone | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
|
OnChanged | Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird. (Von Freezable geerbt.) |
|
|
OnFreezablePropertyChanged(DependencyObject, DependencyObject) | Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden. (Von Freezable geerbt.) |
|
|
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) | Der Member unterstützt die Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen. (Von Freezable geerbt.) |
|
|
OnPropertyChanged | Überschreibt die DependencyObject-Implementierung von OnPropertyChanged, um auch alle Changed-Handler als Reaktion auf eine Änderung einer Abhängigkeitseigenschaft vom Typ Freezable aufzurufen. (Von Freezable geerbt.) |
|
|
ReadLocalValue | Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück. (Von DependencyObject geerbt.) |
|
|
ReadPreamble | Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird. Erben von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Von Freezable geerbt.) |
|
|
SetCurrentValue | Legt den Wert einer -Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Von DependencyObject geerbt.) |
|
|
SetValue(DependencyProperty, Object) | Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird. (Von DependencyObject geerbt.) |
|
|
SetValue(DependencyPropertyKey, Object) | Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die über ihren DependencyPropertyKey-Bezeichner angegeben wird. (Von DependencyObject geerbt.) |
|
|
ShouldSerializeProperty | Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Von DependencyObject geerbt.) |
|
|
ToString() | Gibt eine Zeichenfolgendarstellung für diesen Brush zurück. (Überschreibt Object.ToString().) |
|
|
ToString(IFormatProvider) | Erstellt eine Zeichenfolgendarstellung dieses Objekts anhand der angegebenen kulturspezifischen Formatierungsinformationen. |
|
|
VerifyAccess | Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.) |
|
|
WritePostscript | Löst das Changed-Ereignis für Freezable aus und ruft seine OnChanged-Methode auf. Von Freezable abgeleitete Klassen sollten diese Methode am Ende jeder API aufrufen, die nicht als Abhängigkeitseigenschaften gespeicherte Klassenmember ändert. (Von Freezable geerbt.) |
|
|
WritePreamble | Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird. Erben von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Von Freezable geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
Changed | Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird. (Von Freezable geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
OpacityProperty | Bezeichnet die Opacity-Abhängigkeitseigenschaft. |
|
|
RelativeTransformProperty | Bezeichnet die RelativeTransform-Abhängigkeitseigenschaft. |
|
|
TransformProperty | Bezeichnet die Transform-Abhängigkeitseigenschaft. |
| Name | Beschreibung | |
|---|---|---|
|
IFormattable.ToString | Formatiert den Wert der aktuellen Instanz unter Verwendung des angegebenen Formats. |
Ein Brush "zeichnet" oder “füllt” einen Bereich mit der zugehörigen Ausgabe. Je nach Pinsel kann die Ausgabe einen anderen Typ aufweisen. Einige Pinsel zeichnen einen Bereich mit einer Volltonfarbe, andere mit einem Farbverlauf, Muster, Bild oder einer Zeichnung. Die folgende Liste beschreibt die unterschiedlichen Typen von WPF-Pinseln:
-
SolidColorBrush: Zeichnet einen Bereich mit einer 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 (durch ein ImageSource-Objekt dargestellt).
-
DrawingBrush: Zeichnet einen Bereich mit einer Drawing. Die Zeichnung kann Vektor- und Bitmapobjekte enthalten.
-
VisualBrush: Zeichnet einen Bereich mit einem Visual-Objekt. Mit einem VisualBrush können Sie Inhalt von einem Teil der Anwendung in einen anderen Bereich duplizieren. Dies ist beim Erstellen von Reflektionseffekten und beim Vergrößern von Teilen des Bildschirms sehr nützlich.
Vordefinierte Pinsel
Mit der Brushes-Klasse können Sie ein Objekt in einer vordefinierten Volltonfarbe zeichnen, z. B. AliceBlue oder Red.
Pinsel in XAML
In der folgenden Tabelle werden die verschiedenen Brush-Typen aufgelistet, die in XAML und in der unterstützten Syntax verwendet werden können. Ausführliche Informationen zur Syntax eines bestimmten Pinsels finden Sie auf der Typseite für den Pinsel.
|
Klasse |
Attributsyntax |
Objektelementsyntax |
|---|---|---|
|
Yes |
Yes |
|
|
nein |
Yes |
|
|
Nein |
Yes |
|
|
nein |
Yes |
|
|
nein |
Yes |
|
|
nein |
Yes |
Ein Beispiel, das zeigt, wie ein Bereich schnell mit einer Volltonfarbe gezeichnet wird, finden Sie unter Gewusst wie: Zeichnen eines Bereichs mit einer Volltonfarbe.
Features von Freezable
Ein Pinsel ist ein Typ von Freezable-Objekt. Informationen zu Funktionen von Freezable, z. B. Einfrieren und Klonen, finden Sie in der Übersicht über Freezable-Objekte.
Hinweise zur Vererbung
Wenn Sie von der Brush-Klasse erben, müssen Sie die CreateInstanceCore-Methode überschreiben. In Abhängigkeit davon, ob die Klasse zusätzliche Initialisierungsfunktionen ausführen muss oder Datenmember ohne Abhängigkeitseigenschaften enthält, müssen Sie zusätzliche Freezable-Methoden möglicherweise überschreiben. Weitere Informationen über das Vererben von Freezable-Typen finden Sie unter Übersicht über Freezable-Objekte.
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
