Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Brush-Klasse

 

Veröffentlicht: August 2016

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

Namespace:   System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

System.Object
  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

[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
[TypeConverterAttribute(typeof(BrushConverter))]
public abstract class Brush : Animatable, IFormattable

NameBeschreibung
System_CAPS_protmethodBrush()

Initialisiert eine neue Instanz der Brush-Klasse.

NameBeschreibung
System_CAPS_pubpropertyCanFreeze

Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann.(Geerbt von „Freezable“.)

System_CAPS_pubpropertyDependencyObjectType

Ruft die DependencyObjectType umschließt der CLR Typ dieser Instanz. (Geerbt von „DependencyObject“.)

System_CAPS_pubpropertyDispatcher

Ruft die Dispatcher dies DispatcherObject zugeordnet ist.(Geerbt von „DispatcherObject“.)

System_CAPS_pubpropertyHasAnimatedProperties

Ruft einen Wert, der angibt, ob eine oder mehrere AnimationClock Objekte Abhängigkeitseigenschaften dieses Objekt zugeordnet ist.(Geerbt von „Animatable“.)

System_CAPS_pubpropertyIsFrozen

Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann.(Geerbt von „Freezable“.)

System_CAPS_pubpropertyIsSealed

Ruft einen Wert, der angibt, ob diese Instanz derzeit versiegelt ist (schreibgeschützt).(Geerbt von „DependencyObject“.)

System_CAPS_pubpropertyOpacity

Ruft den Grad der Deckkraft eines Brush ab oder legt ihn fest.

System_CAPS_pubpropertyRelativeTransform

Ruft die auf den Pinsel über relative Koordinaten angewendete Transformation ab oder legt diese fest.

System_CAPS_pubpropertyTransform

Dient zum Abrufen oder Festlegen der auf den Pinsel angewendeten Transformation. Diese Transformation wird angewendet, nachdem die Ausgabe des Pinsels zugeordnet und positioniert wurde.

NameBeschreibung
System_CAPS_pubmethodApplyAnimationClock(DependencyProperty, AnimationClock)

Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet.(Geerbt von „Animatable“.)

System_CAPS_pubmethodApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, dem angegebenen HandoffBehavior verwendet wird.(Geerbt von „Animatable“.)

System_CAPS_pubmethodBeginAnimation(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“.)

System_CAPS_pubmethodBeginAnimation(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, dem angegebenen HandoffBehavior verwendet wird.(Geerbt von „Animatable“.)

System_CAPS_pubmethodCheckAccess()

Bestimmt, ob der aufrufende Thread Zugriff auf diese DispatcherObject.(Geerbt von „DispatcherObject“.)

System_CAPS_pubmethodClearValue(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“.)

System_CAPS_pubmethodClearValue(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“.)

System_CAPS_pubmethodClone()

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.

System_CAPS_protmethodCloneCore(Freezable)

Definiert die Instanz als Klon (tiefe Kopie) des angegebenen Freezable-Elements, indem Basiseigenschaftenwerte (nicht animiert) verwendet werden.(Geerbt von „Freezable“.)

System_CAPS_pubmethodCloneCurrentValue()

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.

System_CAPS_protmethodCloneCurrentValueCore(Freezable)

Macht die Instanz einen änderbaren Klon (tiefe Kopie) des angegebenen Freezable mit aktuellen Eigenschaftswerten.(Geerbt von „Freezable“.)

System_CAPS_pubmethodCoerceValue(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“.)

System_CAPS_protmethodCreateInstance()

Initialisiert eine neue Instanz der Freezable-Klasse.(Geerbt von „Freezable“.)

System_CAPS_protmethodCreateInstanceCore()

Bei Implementierung in einer abgeleiteten Klasse erstellt eine neue Instanz der dem Freezable abgeleitete Klasse.(Geerbt von „Freezable“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob ein bereitgestelltes DependencyObject entspricht dem aktuellen DependencyObject.(Geerbt von „DependencyObject“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodFreeze()

Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf true fest.(Geerbt von „Freezable“.)

System_CAPS_protmethodFreezeCore(Boolean)

Dadurch Animatable Objekt als nicht änderbar fest oder bestimmt, ob es als nicht änderbar festgelegt werden kann.(Geerbt von „Animatable“.)

System_CAPS_pubmethodGetAnimationBaseValue(DependencyProperty)

Gibt den nicht animierten Wert der angegebenen DependencyProperty.(Geerbt von „Animatable“.)

System_CAPS_pubmethodGetAsFrozen()

Erstellt eine fixierte Kopie der Freezable, mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.(Geerbt von „Freezable“.)

System_CAPS_protmethodGetAsFrozenCore(Freezable)

Definiert der Instanz als fixierten Klon des angegebenen Freezable mit Basiseigenschaftswerten (nicht animiert).(Geerbt von „Freezable“.)

System_CAPS_pubmethodGetCurrentValueAsFrozen()

Erstellt eine fixierte Kopie der Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.(Geerbt von „Freezable“.)

System_CAPS_protmethodGetCurrentValueAsFrozenCore(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“.)

System_CAPS_pubmethodGetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodGetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator für die Bestimmung, welche Abhängigkeitseigenschaften lokal auf diesem festgelegte Werte haben DependencyObject.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodGetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

Den tatsächliche Wert für die angegebene Abhängigkeitseigenschaft erneut bewertet werden soll(Geerbt von „DependencyObject“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodOnChanged()

Wird aufgerufen, wenn die aktuelle Freezable Objekt geändert wird.(Geerbt von „Freezable“.)

System_CAPS_protmethodOnFreezablePropertyChanged(DependencyObject, DependencyObject)

Stellt sicher, dass entsprechende Kontextzeiger für eingerichtet werden eine DependencyObjectType Datenmember, die gerade festgelegt wurde.(Geerbt von „Freezable“.)

System_CAPS_protmethodOnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Dieser Member unterstützt die Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.(Geerbt von „Freezable“.)

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

Überschreibt die DependencyObject-Implementierung von OnPropertyChanged, damit in Reaktion auf eine geänderte Abhängigkeitseigenschaft des Typs Freezable auch Changed-Handler aufgerufen werden.(Geerbt von „Freezable“.)

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist.(Geerbt von „DependencyObject“.)

System_CAPS_protmethodReadPreamble()

Stellt sicher, dass die Freezable über einen gültigen Thread zugegriffen wird. Erben der Freezable muss diese Methode aufrufen, die zu Beginn eines beliebigen API liest Datenmember, die keine Abhängigkeitseigenschaften sind.(Geerbt von „Freezable“.)

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodSetValue(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“.)

System_CAPS_protmethodShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodToString()

Zeichenfolgendarstellung dieser zurückgeben Brush.(Überschreibt Object.ToString().)

System_CAPS_pubmethodToString(IFormatProvider)

Erstellt eine Zeichenfolgendarstellung für dieses Objekt basierend auf der angegebenen kulturabhängigen Formatierungsinformationen.

System_CAPS_pubmethodVerifyAccess()

Erzwingt, dass der aufrufende Thread den Zugriff auf diese kann DispatcherObject.(Geerbt von „DispatcherObject“.)

System_CAPS_protmethodWritePostscript()

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“.)

System_CAPS_protmethodWritePreamble()

Überprüft, ob die Freezable ist nicht fixiert und, die sie über einen gültigen Threadkontext zugegriffen wird. Freezable erbenden Klassen sollten diese Methode aufrufen, die zu Beginn eines beliebigen API schreibt auf Datenmember, die keine Abhängigkeitseigenschaften sind.(Geerbt von „Freezable“.)

NameBeschreibung
System_CAPS_pubfieldSystem_CAPS_staticOpacityProperty

Bezeichnet die Opacity-Abhängigkeitseigenschaft.

System_CAPS_pubfieldSystem_CAPS_staticRelativeTransformProperty

Bezeichnet die RelativeTransform-Abhängigkeitseigenschaft.

System_CAPS_pubfieldSystem_CAPS_staticTransformProperty

Bezeichnet die Transform-Abhängigkeitseigenschaft.

NameBeschreibung
System_CAPS_pubeventChanged

Tritt auf, wenn die Freezable oder ein darin enthaltenes Objekt geändert wurde.(Geerbt von „Freezable“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIFormattable.ToString(String, IFormatProvider)

Formatiert den Wert der aktuellen Instanz mit dem angegebenen Format.

Ein Brush "zeichnet" oder "füllt" einen Bereich mit der Ausgabe. Unterschiedlicher Pinsel werden verschiedene Typen der Ausgabe aufweisen. Einige Pinsel zeichnen einen Bereich mit einer Volltonfarbe, andere Personen mit einem Farbverlauf, Muster, Bild oder Zeichnung. Die folgende Liste beschreibt die verschiedenen Typen von WPF Pinsel:

  • SolidColorBrush: Zeichnet einen Bereich mit einer einfarbigen 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 eine ImageSource Objekt).

  • DrawingBrush: Zeichnet einen Bereich mit einem Drawing. Die Zeichnung kann Vektor- und Bitmap-Objekte enthalten.

  • VisualBrush: Zeichnet einen Bereich mit einem Visual Objekt. Ein VisualBrush ermöglicht es Ihnen, den Inhalt von einem Teil der Anwendung in einem anderen Client-Bereich duplizieren diese Funktion ist hilfreich zum Erstellen von Reflektion Auswirkungen und Teile des Bildschirms vergrößern.

Verwenden der Brushes Klasse, um ein Objekt mit einer vordefinierten Volltonfarbe wie zeichnen AliceBlue oder Red.

Die folgende Tabelle enthält die verschiedenen Brush Typen, die in zu verwendenden XAML und die Syntax, die sie unterstützen. Ausführliche Informationen zur Syntax für einen bestimmten Pinsel finden Sie unter Seite "des Pinsels".

class

Die Attributsyntax

Die Syntax der Object-Element

SolidColorBrush

Ja

Ja

DrawingBrush

Nein

Ja

ImageBrush

Nein

Ja

LinearGradientBrush

Nein

Ja

RadialGradientBrush

Nein

Ja

VisualBrush

Nein

Ja

Ein Beispiel zeigt, wie schnell einen Bereich mit einer Volltonfarbe gezeichnet wird, finden Sie unter wie: Zeichnen eines Bereichs mit einer Volltonfarbe.

Ein Pinsel ist eine Art von Freezable Objekt. Informationen zu Freezable Funktionen, z. B. Einfrieren und Klonen, finden Sie unter der Freezable Objects Overview.

Für XAML Informationen finden Sie unter der "Hinweise" Abschnitt.

Hinweise für Vererber:

Beim Erben von der Brush -Klasse, die Sie überschreiben müssen die CreateInstanceCore Methode. Je nachdem, ob die Klasse zusätzliche Initialisierungsfunktionen ausführen muss oder nicht Abhängigkeitseigenschaft-Datenmember enthält, müssen möglicherweise außer Kraft setzen zusätzliche Freezable Methoden. Weitere Informationen über das Vererben von Freezable , finden Sie unter der Freezable Objects Overview.

.NET Framework
Verfügbar seit 3.0
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: