TileBrush Klasse

Definition

Beschreibt eine Möglichkeit, einen Bereich mithilfe von einer oder mehreren Kachel(n) zu zeichnen.Describes a way to paint a region by using one or more tiles.

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, mit denen Sie einen Bereich zeichnen.The derived classes of TileBrush define the contents of the tiles that you use to paint a region. Verwenden Sie z. b. die ImageBrush-Klasse, um einen Bereich mithilfe eines Bilds zu zeichnen.For example, use the ImageBrush class to paint an area by using an image.

Verwenden Sie einen TileBrush, um zu steuern, wie Sie einen Bereich zeichnen.Use a TileBrush to control how you paint an area. Beispielsweise stellt Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) verschiedene Arten von Pinseln bereit:For example, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) provides several types of brushes:

Wenn Sie den TileBrush verwenden, um einen Bereich zu zeichnen, anstatt einen Bereich mithilfe eines einzelnen gestreckten Bilds zu zeichnen, können Sie einen Bereich zeichnen, indem Sie eine Reihe von Bildkacheln verwenden, die ein Muster erstellen.When you use the TileBrush to paint an area, instead of painting an area by using a single stretched image, you can paint an area by using a series of image tiles that create a pattern.

Wenn Sie einen Bereich mithilfe eines TileBrush zeichnen, verwenden Sie drei Komponenten: Inhalt, Kacheln und den Ausgabebereich.When you paint an area by using a TileBrush, you use three components: content, tiles, and the output area. In den folgenden Abbildungen wird gezeigt, wie diese drei TileBrush-Komponenten zueinander zueinander stehen.The following illustrations show how these three TileBrush components relate to each other.

TileBrush-KomponenteTileBrush components
Komponenten eines TileBrush mit einer einzelnen KachelComponents of a TileBrush with a single tile

Komponenten eines gekachelten TileBrushComponents of a tiled TileBrush
Komponenten eines TileBrush mit einer TileMode-KachelComponents of a TileBrush with a TileMode of Tile

Inhalt: Ein TileBrush kann unterschiedliche Inhaltstypen aufweisen:Content: A TileBrush can have different types of content:

Sie können die Position und die Dimensionen des TileBrush-Inhalts angeben, indem Sie die Viewbox-Eigenschaft verwenden.You can specify the position and dimensions of TileBrush content by using the Viewbox property.

Kacheln: Ein TileBrush erzeugt eine oder mehrere Kacheln.Tiles: A TileBrush produces one or more tiles. Standardmäßig wird der Inhalt des Pinsels gestreckt, um eine einzelne Kachel auszufüllen, und diese Kachel wird gestreckt, um den Ausgabebereich auszufüllen.By default, the content of the brush is stretched to fill a single tile and that tile is stretched to fill the output area. Die Viewport-Eigenschaft wird verwendet, um die Größe und Position der Basis Kachel für den TileBrush anzugeben.The Viewport property is used to specify the size and position of the base tile for the TileBrush. Die ViewportUnits-Eigenschaft bestimmt, ob die Größe und die Position des Viewport relativ zum Ausgabebereich (Standardverhalten) sind oder ob es sich um absolute Werte handelt.The ViewportUnits property determines whether the size and position of the Viewport are relative to the output area (the default behavior) or whether they are absolute values.

Ausgabebereich: Der Ausgabebereich ist der Bereich, den der Pinsel zeichnet, z. b. der Fill eines Ellipse oder der Background einer Button.Output Area: The output area is the area that the brush paints, such as the Fill of an Ellipse or the Background of a Button.

Weitere Informationen zur TileBrush-Klasse finden Sie unterzeichnen mit Bildern, Zeichnungen und visuellen Elementen.For more information about the TileBrush class, see Painting with Images, Drawings, and Visuals .

Funktionen von Freezable-ObjektenFreezable Features

Ein TileBrush ist ein Freezable-Typ.A TileBrush is a Freezable type. Informationen zu Freezable-Features, z. b. zum Einfrieren und Klonen, finden Sie in der Übersicht überdie frei wählbare Objekte.For information about Freezable features, such as freezing and cloning, see the Freezable Objects Overview.

Hinweise für Vererber

Wenn Sie von der TileBrush-Klasse erben, müssen Sie die CreateInstanceCore()-Methode überschreiben.When you inherit from the TileBrush class, you must override the CreateInstanceCore() method. Weitere Informationen zum Erben von Freezable-Typen finden Sie in der Übersicht überfrei wählbare Objekte.For more information about inheriting from Freezable types, see the Freezable Objects Overview.

Konstruktoren

TileBrush()

Stellt beim Aufruf durch den Konstruktor einer abgeleiteten Klasse die Initialisierung für Basisklassenwerte bereit.Provides initialization for base class values when called by the constructor of a derived class.

Felder

AlignmentXProperty

Bezeichnet die AlignmentX-Abhängigkeitseigenschaft.Identifies the AlignmentX dependency property.

AlignmentYProperty

Bezeichnet die AlignmentY-Abhängigkeitseigenschaft.Identifies the AlignmentY dependency property.

StretchProperty

Bezeichnet die Stretch-Abhängigkeitseigenschaft.Identifies the Stretch dependency property.

TileModeProperty

Bezeichnet die TileMode-Abhängigkeitseigenschaft.Identifies the TileMode dependency property.

ViewboxProperty

Bezeichnet die Viewbox-Abhängigkeitseigenschaft.Identifies the Viewbox dependency property.

ViewboxUnitsProperty

Bezeichnet die ViewboxUnits-Abhängigkeitseigenschaft.Identifies the ViewboxUnits dependency property.

ViewportProperty

Bezeichnet die Viewport-Abhängigkeitseigenschaft.Identifies the Viewport dependency property.

ViewportUnitsProperty

Bezeichnet die ViewportUnits-Abhängigkeitseigenschaft.Identifies the ViewportUnits dependency property.

Eigenschaften

AlignmentX

Ruft die horizontale Ausrichtung des Inhalts in der TileBrush-Basiskachel ab oder legt diese fest.Gets or sets the horizontal alignment of content in the TileBrush base tile.

AlignmentY

Ruft die vertikale Ausrichtung des Inhalts in der TileBrush-Basiskachel ab oder legt diese fest.Gets or sets the vertical alignment of content in the TileBrush base tile.

CanFreeze

Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann.Gets a value that indicates whether the object can be made unmodifiable.

(Geerbt von Freezable)
DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Geerbt von DependencyObject)
Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
HasAnimatedProperties

Ruft einen Wert ab, der angibt, ob einer der Abhängigkeitseigenschaften dieses Objekts ein oder mehrere AnimationClock-Objekte zugeordnet sind.Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(Geerbt von Animatable)
IsFrozen

Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann.Gets a value that indicates whether the object is currently modifiable.

(Geerbt von Freezable)
IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(Geerbt von DependencyObject)
Opacity

Ruft den Grad der Deckkraft eines Brush ab oder legt ihn fest.Gets or sets the degree of opacity of a Brush.

(Geerbt von Brush)
RelativeTransform

Ruft die auf den Pinsel über relative Koordinaten angewendete Transformation ab oder legt diese fest.Gets or sets the transformation that is applied to the brush using relative coordinates.

(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.Gets or sets a value that specifies how the content of this TileBrush stretches to fit its tiles.

TileMode

Ruft einen Wert ab, der angibt, wie ein TileBrush den gezeichneten Bereich ausfüllt, wenn die Basiskachel kleiner als der Ausgabebereich ist, oder legt diesen fest.Gets or sets a value that specifies how a TileBrush fills the area that you are painting if the base tile is smaller than the output area.

Transform

Dient zum Abrufen oder Festlegen der auf den Pinsel angewendeten Transformation.Gets or sets the transformation that is applied to the brush. Diese Transformation wird angewendet, nachdem die Ausgabe des Pinsels zugeordnet und positioniert wurde.This transformation is applied after the brush's output has been mapped and positioned.

(Geerbt von Brush)
Viewbox

Ruft Position und Abmessungen des Inhalts in einer TileBrush-Kachel ab oder legt diese fest.Gets or sets the position and dimensions of the content in a TileBrush tile.

ViewboxUnits

Ruft einen Wert ab, der angibt, ob der Viewbox-Wert relativ zum umgebenden Rechteck des TileBrush oder als absoluter Wert interpretiert wird, oder legt diesen fest.Gets or sets a value that specifies whether the Viewbox value is relative to the bounding box of the TileBrush contents or whether the value is absolute.

Viewport

Ruft Position und Abmessungen der Basiskachel für einen TileBrush ab oder legt diese fest.Gets or sets the position and dimensions of the base tile for a TileBrush.

ViewportUnits

Ruft eine BrushMappingMode-Enumeration ab, die angibt, ob der Wert des Viewport, der Größe und Position der TileBrush-Basiskachel beschreibt, relativ zur Größe des Ausgabebereichs interpretiert wird, oder legt diese fest.Gets or sets a BrushMappingMode enumeration that specifies whether the value of the Viewport, which indicates the size and position of the TileBrush base tile, is relative to the size of the output area.

Methoden

ApplyAnimationClock(DependencyProperty, AnimationClock)

Wendet einen AnimationClock auf die angegebene DependencyProperty an.Applies an AnimationClock to the specified DependencyProperty. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(Geerbt von Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Wendet einen AnimationClock auf die angegebene DependencyProperty an.Applies an AnimationClock to the specified DependencyProperty. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet.If the property is already animated, the specified HandoffBehavior is used.

(Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Wendet eine Animation auf die angegebene DependencyProperty an.Applies an animation to the specified DependencyProperty. Die Animation wird gestartet, wenn der nächste Frame gerendert wird.The animation is started when the next frame is rendered. Wenn die angegebene Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet.If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Wendet eine Animation auf die angegebene DependencyProperty an.Applies an animation to the specified DependencyProperty. Die Animation wird gestartet, wenn der nächste Frame gerendert wird.The animation is started when the next frame is rendered. Wenn die angegebene Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet.If the specified property is already animated, the specified HandoffBehavior is used.

(Geerbt von Animatable)
CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Geerbt von DependencyObject)
Clone()

Erstellt eine änderbare Kopie dieses TileBrush -Objekts, indem tiefe Kopien seiner Werte erstellt werden.Creates a modifiable copy of this TileBrush by making deep copies of its values.

CloneCore(Freezable)

Definiert die Instanz als Klon (tiefe Kopie) des angegebenen Freezable-Elements, indem Basiseigenschaftenwerte (nicht animiert) verwendet werden.Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Geerbt von Freezable)
CloneCurrentValue()

Erstellt eine änderbare Kopie des TileBrush-Objekts, indem tiefe Kopien seiner Werte erzeugt werden.Creates a modifiable copy of this TileBrush object by making deep copies of its values. Mit dieser Methode werden keine Ressourcenverweise, Datenbindungen oder Animationen kopiert, ihre aktuellen Werte werden jedoch kopiert.This method does not copy resource references, data bindings, or animations, although it does copy their current values.

CloneCurrentValueCore(Freezable)

Macht die Instanz mithilfe aktueller Eigenschaftswerte zu einem Klon (tiefe Kopie) des angegebenen Freezable-Elements, der geändert werden kann.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Geerbt von Freezable)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Geerbt von DependencyObject)
CreateInstance()

Initialisiert eine neue Instanz der Freezable-Klasse.Initializes a new instance of the Freezable class.

(Geerbt von Freezable)
CreateInstanceCore()

Erstellt beim Implementieren in einer abgeleiteten Klasse eine neue Instanz der abgeleiteten Freezable-Klasse.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Geerbt von Freezable)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Geerbt von DependencyObject)
Freeze()

Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf true fest.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Geerbt von Freezable)
FreezeCore(Boolean)

Legt dieses Animatable-Objekt als nicht änderbar fest oder bestimmt, ob es als nicht änderbar festgelegt werden kann.Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(Geerbt von Animatable)
GetAnimationBaseValue(DependencyProperty)

Gibt den nicht animierten Wert der angegebenen DependencyProperty zurück.Returns the non-animated value of the specified DependencyProperty.

(Geerbt von Animatable)
GetAsFrozen()

Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert).Creates a frozen copy of the Freezable, using base (non-animated) property values. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Geerbt von Freezable)
GetAsFrozenCore(Freezable)

Definiert die Instanz als fixierten Klon des angegebenen Freezable-Elements, indem Basiseigenschaftenwerte (nicht animiert) verwendet werden.Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Geerbt von Freezable)
GetContentBounds(Rect)

Ruft die die aktuellen Begrenzungen des TileBrush-Inhalts ab.Obtains the current bounds of the TileBrush content.

GetCurrentValueAsFrozen()

Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten.Creates a frozen copy of the Freezable using current property values. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Geerbt von Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Legt die aktuelle Instanz als fixierten Klon des angegebenen Freezable fest.Makes the current instance a frozen clone of the specified Freezable. Wenn das Objekt über animierte Abhängigkeitseigenschaften verfügt, werden die aktuellen animierten Werte kopiert.If the object has animated dependency properties, their current animated values are copied.

(Geerbt von Freezable)
GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.Gets a hash code for this DependencyObject.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnChanged()

Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird.Called when the current Freezable object is modified.

(Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Dieser Member unterstützt die Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(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.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Geerbt von Freezable)
ReadLocalValue(DependencyProperty)

Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück.Returns the local value of a dependency property, if it exists.

(Geerbt von DependencyObject)
ReadPreamble()

Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird.Ensures that the Freezable is being accessed from a valid thread. Vererber von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Geerbt von Freezable)
SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Geerbt von DependencyObject)
ToString()

Gibt eine Zeichenfolgendarstellung für diesen Brush zurück.Return string representation of this Brush.

(Geerbt von Brush)
ToString(IFormatProvider)

Erstellt eine Zeichenfolgendarstellung dieses Objekts anhand der angegebenen kulturspezifischen Formatierungsinformationen.Creates a string representation of this object based on the specified culture-specific formatting information.

(Geerbt von Brush)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
WritePostscript()

Löst das Changed-Ereignis für das Freezable-Objekt aus und ruft dessen OnChanged()-Methode auf.Raises the Changed event for the Freezable and invokes its OnChanged() method. Klassen, die aus Freezable abgeleitet werden, sollten diese Methode am Ende jeder API aufrufen, die Klassenmember ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Geerbt von Freezable)
WritePreamble()

Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Vererber von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Geerbt von Freezable)

Ereignisse

Changed

Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird.Occurs when the Freezable or an object it contains is modified.

(Geerbt von Freezable)

Explizite Schnittstellenimplementierungen

IFormattable.ToString(String, IFormatProvider)

Formatiert den Wert der aktuellen Instanz unter Verwendung des angegebenen Formats.Formats the value of the current instance using the specified format.

(Geerbt von Brush)

Gilt für:

Siehe auch