Teilen über


TileBrush Klasse

Definition

Beschreibt eine Möglichkeit, einen Bereich mithilfe von einer oder mehreren Kachel(n) zu zeichnen.

public ref class TileBrush abstract : System::Windows::Media::Brush
public abstract class TileBrush : System.Windows.Media.Brush
type TileBrush = class
    inherit Brush
Public MustInherit Class TileBrush
Inherits Brush
Vererbung
Abgeleitet

Hinweise

Die abgeleiteten Klassen von TileBrush definieren den Inhalt der Kacheln, die Sie zum Zeichnen eines Bereichs verwenden. Verwenden Sie beispielsweise die ImageBrush -Klasse, um einen Bereich mit einem Bild zu zeichnen.

Verwenden Sie ein TileBrush , um zu steuern, wie Sie einen Bereich zeichnen. Beispielsweise stellt Windows Presentation Foundation (WPF) mehrere Pinseltypen bereit:

Wenn Sie den TileBrush verwenden, um einen Bereich zu malen, anstatt einen Bereich mit einem einzelnen gestreckten Bild zu malen, können Sie einen Bereich mit einer Reihe von Bildkacheln zeichnen, die ein Muster erstellen.

Wenn Sie einen Bereich mit einem TileBrushzeichnen, verwenden Sie drei Komponenten: Inhalt, Kacheln und ausgabebereich. Die folgenden Abbildungen zeigen, wie diese drei TileBrush Komponenten miteinander in Beziehung stehen.

TileBrush-Komponenten
Komponenten eines TileBrush mit einer einzelnen Kachel

Komponenten einer gekachelten TileBrush-Komponente
Komponenten eines TileBrush mit einer TileMode-Kachel

Inhalt: A TileBrush kann verschiedene Inhaltstypen aufweisen:

Sie können die Position und Dimensionen von TileBrush Inhalten mithilfe der Viewbox -Eigenschaft angeben.

Kacheln: A TileBrush erzeugt eine oder mehrere Kacheln. Standardmäßig wird der Inhalt des Pinsels so gestreckt, dass er eine einzelne Kachel füllt, und diese Kachel wird gestreckt, um den Ausgabebereich zu füllen. Die Viewport -Eigenschaft wird verwendet, um die Größe und Position der Basiskachel für anzugeben TileBrush. Die ViewportUnits -Eigenschaft bestimmt, ob die Größe und Position des Viewport relativ zum Ausgabebereich (dem Standardverhalten) oder ob es sich um absolute Werte handelt.

Ausgabebereich: Der Ausgabebereich ist der Bereich, den der Pinsel zeichnet, z. B. der Fill eines Ellipse oder eines ButtonBackground .

Weitere Informationen zur TileBrush Klasse finden Sie unter Malen mit Bildern, Zeichnungen und Visuals .

Features von Freezable

A TileBrush ist ein Freezable Typ. Informationen zu Freezable Features wie Einfrieren und Klonen finden Sie in der Übersicht über Freezable-Objekte.

Hinweise für Ausführende

Wenn Sie von der TileBrush -Klasse erben, müssen Sie die CreateInstanceCore() -Methode überschreiben. Weitere Informationen zum Erben von Freezable Typen finden Sie in der Übersicht über Freezable-Objekte.

Konstruktoren

TileBrush()

Stellt beim Aufruf durch den Konstruktor einer abgeleiteten Klasse die Initialisierung für Basisklassenwerte bereit.

Felder

AlignmentXProperty

Bezeichnet die AlignmentX-Abhängigkeitseigenschaft.

AlignmentYProperty

Bezeichnet die AlignmentY-Abhängigkeitseigenschaft.

StretchProperty

Bezeichnet die Stretch-Abhängigkeitseigenschaft.

TileModeProperty

Bezeichnet die TileMode-Abhängigkeitseigenschaft.

ViewboxProperty

Bezeichnet die Viewbox-Abhängigkeitseigenschaft.

ViewboxUnitsProperty

Bezeichnet die ViewboxUnits-Abhängigkeitseigenschaft.

ViewportProperty

Bezeichnet die Viewport-Abhängigkeitseigenschaft.

ViewportUnitsProperty

Bezeichnet die ViewportUnits-Abhängigkeitseigenschaft.

Eigenschaften

AlignmentX

Ruft die horizontale Ausrichtung von Inhalt in der TileBrush-Basiskachel ab oder legt diese fest.

AlignmentY

Ruft die vertikale Ausrichtung von Inhalt in der TileBrush-Basiskachel ab oder legt diese fest.

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.

(Geerbt von Brush)
RelativeTransform

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

(Geerbt von Brush)
Stretch

Ruft ab einen Wert ab oder legt diesen fest, der angibt, wie der Inhalt dieses TileBrush gestreckt wird, um ihn auf seine Kacheln anzupassen.

TileMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, wie ein Bereich mit einem TileBrush-Effekt (Kacheleffekt) ausgefüllt wird, wenn die Basiskachel kleiner ist als der Ausgabebereich.

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.

(Geerbt von Brush)
Viewbox

Ruft die Position und Abmessungen des Inhalts einer TileBrush-Kachel ab oder legt sie fest.

ViewboxUnits

Ruft einen Wert ab oder legt diesen fest, der angibt, ob der Viewbox-Wert relativ zum umgebenden Feld für die TileBrush-Inhalte oder absolut ist.

Viewport

Ruft die Position und Abmessungen der Basiskachel für einen TileBrush ab oder legt sie fest.

ViewportUnits

Ruft eine BrushMappingMode-Enumeration ab bzw. legt eine Enumeration fest, die angibt, ob sich der Viewport-Wert, der die Größe und Position der TileBrush-Basiskachel angibt, relativ zur Größe des Ausgabebereichs verhält.

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 eine änderbare Kopie dieses TileBrush-Objekts, indem tiefe Kopien seiner Werte erzeugt werden.

CloneCore(Freezable)

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

(Geerbt von Freezable)
CloneCurrentValue()

Erstellt eine änderbare Kopie des TileBrush-Objekts, indem tiefe Kopien seiner Werte erzeugt werden. Mit dieser Methode werden keine Ressourcenverweise, Datenbindungen oder Animationen 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)
GetContentBounds(Rect)

Ruft die die aktuellen Begrenzungen des TileBrush-Inhalts ab.

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.

(Geerbt von Brush)
ToString(IFormatProvider)

Erstellt eine Zeichenfolgendarstellung dieses Objekts anhand der angegebenen kulturspezifischen Formatierungsinformationen.

(Geerbt von Brush)
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.

(Geerbt von Brush)

Gilt für:

Weitere Informationen