TileBrush Klasa

Definicja

Opisuje sposób malowania regionu przy użyciu co najmniej jednego kafelka.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
Dziedziczenie
Pochodne

Uwagi

Klasy pochodne TileBrush definiują zawartość kafelków, które są używane do malowania regionu.The derived classes of TileBrush define the contents of the tiles that you use to paint a region. Na przykład użyj klasy ImageBrush, aby malować obszar przy użyciu obrazu.For example, use the ImageBrush class to paint an area by using an image.

Użyj TileBrush, aby kontrolować sposób malowania obszaru.Use a TileBrush to control how you paint an area. Na przykład Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) zawiera kilka typów pędzli:For example, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) provides several types of brushes:

W przypadku używania TileBrush do malowania obszaru zamiast malowania obszaru przy użyciu pojedynczego rozciąganego obrazu można malować obszar przy użyciu serii obrazów, które tworzą wzorzec.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.

Podczas malowania obszaru za pomocą TileBrush są używane trzy składniki: zawartość, kafelki i obszar wyjściowy.When you paint an area by using a TileBrush, you use three components: content, tiles, and the output area. Na poniższych ilustracjach pokazano, jak te trzy składniki TileBrush są powiązane ze sobą.The following illustrations show how these three TileBrush components relate to each other.

Elementy TileBrushTileBrush components
Składniki obiektu TileBrush z jednym kafelkiemComponents of a TileBrush with a single tile

Składniki sąsiadującego obiektu TileBrushComponents of a tiled TileBrush
Składniki obiektu TileBrush z kafelkiem kafelkaComponents of a TileBrush with a TileMode of Tile

Zawartość: TileBrush może mieć różne typy zawartości:Content: A TileBrush can have different types of content:

Możesz określić pozycję i wymiary TileBrush zawartości przy użyciu właściwości Viewbox.You can specify the position and dimensions of TileBrush content by using the Viewbox property.

Kafelki: TileBrush tworzy jeden lub więcej kafelków.Tiles: A TileBrush produces one or more tiles. Domyślnie zawartość pędzla jest rozciągana w celu wypełnienia jednego kafelka, a kafelek jest rozciągany w celu wypełnienia obszaru wyjściowego.By default, the content of the brush is stretched to fill a single tile and that tile is stretched to fill the output area. Właściwość Viewport służy do określania rozmiaru i pozycji podstawowego kafelka TileBrush.The Viewport property is used to specify the size and position of the base tile for the TileBrush. Właściwość ViewportUnits określa, czy rozmiar i położenie Viewport są względne względem obszaru wyjściowego (zachowanie domyślne) czy są wartościami bezwzględnymi.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.

Obszar wyjściowy: obszar danych wyjściowych to obszar, który maluje pędzle, taki jak Fill Ellipse lub Background 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.

Aby uzyskać więcej informacji na temat klasy TileBrush, zobacz malowanie przy użyciu obrazów, rysunków i wizualizacji .For more information about the TileBrush class, see Painting with Images, Drawings, and Visuals .

Funkcje freezableFreezable Features

@No__t_0 jest typem Freezable.A TileBrush is a Freezable type. Aby uzyskać informacje na temat funkcji Freezable, takich jak zamrażanie i klonowanie, zobacz Omówienie obiektów Freezable.For information about Freezable features, such as freezing and cloning, see the Freezable Objects Overview.

Uwagi dotyczące implementowania

W przypadku dziedziczenia z klasy TileBrush należy zastąpić metodę CreateInstanceCore().When you inherit from the TileBrush class, you must override the CreateInstanceCore() method. Aby uzyskać więcej informacji na temat dziedziczenia z typów Freezable, zobacz Omówienie obiektów Freezable.For more information about inheriting from Freezable types, see the Freezable Objects Overview.

Konstruktory

TileBrush()

Zapewnia inicjalizację wartości klasy bazowej, gdy jest wywoływana przez konstruktora klasy pochodnej.Provides initialization for base class values when called by the constructor of a derived class.

Pola

AlignmentXProperty

Identyfikuje właściwość zależności AlignmentX.Identifies the AlignmentX dependency property.

AlignmentYProperty

Identyfikuje właściwość zależności AlignmentY.Identifies the AlignmentY dependency property.

StretchProperty

Identyfikuje właściwość zależności Stretch.Identifies the Stretch dependency property.

TileModeProperty

Identyfikuje właściwość zależności TileMode.Identifies the TileMode dependency property.

ViewboxProperty

Identyfikuje właściwość zależności Viewbox.Identifies the Viewbox dependency property.

ViewboxUnitsProperty

Identyfikuje właściwość zależności ViewboxUnits.Identifies the ViewboxUnits dependency property.

ViewportProperty

Identyfikuje właściwość zależności Viewport.Identifies the Viewport dependency property.

ViewportUnitsProperty

Identyfikuje właściwość zależności ViewportUnits.Identifies the ViewportUnits dependency property.

Właściwości

AlignmentX

Pobiera lub Ustawia wyrównanie w poziomie zawartości na kafelku podstawowym TileBrush.Gets or sets the horizontal alignment of content in the TileBrush base tile.

AlignmentY

Pobiera lub Ustawia wyrównanie w pionie zawartości na kafelku podstawowym TileBrush.Gets or sets the vertical alignment of content in the TileBrush base tile.

CanFreeze

Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny.Gets a value that indicates whether the object can be made unmodifiable.

(Odziedziczone po Freezable)
DependencyObjectType

Pobiera DependencyObjectType, które zawijają typ CLRCLR tego wystąpienia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Dispatcher Pobiera ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
HasAnimatedProperties

Pobiera wartość wskazującą, czy co najmniej jeden AnimationClock obiekt jest skojarzony z żadną z właściwości zależności tego obiektu.Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(Odziedziczone po Animatable)
IsFrozen

Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny.Gets a value that indicates whether the object is currently modifiable.

(Odziedziczone po Freezable)
IsSealed

Pobiera wartość wskazującą, czy to wystąpienie jest aktualnie zapieczętowane (tylko do odczytu).Gets a value that indicates whether this instance is currently sealed (read-only).

(Odziedziczone po DependencyObject)
Opacity

Pobiera lub ustawia stopień nieprzezroczystości Brush.Gets or sets the degree of opacity of a Brush.

(Odziedziczone po Brush)
RelativeTransform

Pobiera lub ustawia transformację stosowaną do pędzla przy użyciu współrzędnych względnych.Gets or sets the transformation that is applied to the brush using relative coordinates.

(Odziedziczone po Brush)
Stretch

Pobiera lub ustawia wartość określającą, jak zawartość tego TileBrush rozciąga się w celu dopasowania do jego kafelków.Gets or sets a value that specifies how the content of this TileBrush stretches to fit its tiles.

TileMode

Pobiera lub ustawia wartość określającą, jak TileBrush wypełnia obszar, w którym odbywa się malowanie, jeśli kafelek podstawowy jest mniejszy niż obszar wyjściowy.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

Pobiera lub ustawia transformację stosowaną do pędzla.Gets or sets the transformation that is applied to the brush. To przekształcenie jest stosowane po zmapowaniu i założeniu wyjścia pędzla.This transformation is applied after the brush's output has been mapped and positioned.

(Odziedziczone po Brush)
Viewbox

Pobiera lub ustawia pozycję i wymiary zawartości w kafelku TileBrush.Gets or sets the position and dimensions of the content in a TileBrush tile.

ViewboxUnits

Pobiera lub ustawia wartość określającą, czy wartość Viewbox jest określana względem pola ograniczenia zawartości TileBrush lub czy wartość jest bezwzględna.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

Pobiera lub ustawia pozycję i wymiary kafelka podstawowego dla TileBrush.Gets or sets the position and dimensions of the base tile for a TileBrush.

ViewportUnits

Pobiera lub ustawia Wyliczenie BrushMappingMode określające, czy wartość Viewport, która wskazuje rozmiar i położenie kafelka podstawowego TileBrush, jest względem rozmiaru obszaru wyjściowego.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.

Metody

ApplyAnimationClock(DependencyProperty, AnimationClock)

Stosuje do określonego DependencyProperty. AnimationClockApplies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie podczas przedania.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(Odziedziczone po Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Stosuje do określonego DependencyProperty. AnimationClockApplies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior .If the property is already animated, the specified HandoffBehavior is used.

(Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Stosuje animację do określonego DependencyProperty.Applies an animation to the specified DependencyProperty. Animacja jest uruchamiana, gdy Następna ramka jest renderowana.The animation is started when the next frame is rendered. Jeśli określona właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie podczas przedania.If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Stosuje animację do określonego DependencyProperty.Applies an animation to the specified DependencyProperty. Animacja jest uruchamiana, gdy Następna ramka jest renderowana.The animation is started when the next frame is rendered. Jeśli określona właściwość jest już animowana, zostanie użyta określona HandoffBehavior .If the specified property is already animated, the specified HandoffBehavior is used.

(Odziedziczone po Animatable)
CheckAccess()

Określa, czy wątek wywołujący ma dostęp do DispatcherObjecttego.Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez identyfikator DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Odziedziczone po DependencyObject)
Clone()

Tworzy modyfikowalną kopię tego TileBrush, tworząc głębokie kopie swoich wartości.Creates a modifiable copy of this TileBrush by making deep copies of its values.

CloneCore(Freezable)

Sprawia, że wystąpienie jest klonem (głębokiej kopii) określonego Freezable przy użyciu podstawowych (nieanimowanych) wartości właściwości.Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Odziedziczone po Freezable)
CloneCurrentValue()

Tworzy modyfikowalną kopię tego obiektu TileBrush, tworząc głębokie kopie swoich wartości.Creates a modifiable copy of this TileBrush object by making deep copies of its values. Ta metoda nie kopiuje odwołań do zasobów, powiązań danych ani animacji, chociaż kopiuje ich bieżące wartości.This method does not copy resource references, data bindings, or animations, although it does copy their current values.

CloneCurrentValueCore(Freezable)

Sprawia, że wystąpienie jest modyfikowalnym klonem (głębokiej kopii) określonego Freezable przy użyciu bieżących wartości właściwości.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Odziedziczone po Freezable)
CoerceValue(DependencyProperty)

Przekształca wartość określonej właściwości zależności.Coerces the value of the specified dependency property. W tym celu należy wywołać dowolną funkcję CoerceValueCallback określoną w metadanych właściwości dla właściwości zależności, która istnieje w DependencyObjectwywoływania.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Odziedziczone po DependencyObject)
CreateInstance()

Inicjuje nowe wystąpienie klasy Freezable.Initializes a new instance of the Freezable class.

(Odziedziczone po Freezable)
CreateInstanceCore()

Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie klasy pochodnej Freezable.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Odziedziczone po Freezable)
Equals(Object)

Określa, czy podana DependencyObject jest równoważna z bieżącym DependencyObject.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Odziedziczone po DependencyObject)
Freeze()

Sprawia, że bieżący obiekt jest niemodyfikowalny i ustawia jego właściwość IsFrozen na true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Odziedziczone po Freezable)
FreezeCore(Boolean)

Sprawia, Animatable że ten obiekt jest niemodyfikowalny lub określa, czy można go nie modyfikować.Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(Odziedziczone po Animatable)
GetAnimationBaseValue(DependencyProperty)

Zwraca nieanimowaną wartość określonego DependencyPropertyelementu.Returns the non-animated value of the specified DependencyProperty.

(Odziedziczone po Animatable)
GetAsFrozen()

Tworzy zamrożoną kopię Freezableprzy użyciu podstawowych (nieanimowanych) wartości właściwości.Creates a frozen copy of the Freezable, using base (non-animated) property values. Ponieważ kopia jest zamrożona, wszelkie zamrożone obiekty podrzędne są kopiowane przez odwołanie.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Odziedziczone po Freezable)
GetAsFrozenCore(Freezable)

Sprawia, że wystąpienie jest zablokowanym klonem określonego Freezable przy użyciu podstawowych (nieanimowanych) wartości właściwości.Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Odziedziczone po Freezable)
GetContentBounds(Rect)

Uzyskuje bieżące granice zawartości TileBrush.Obtains the current bounds of the TileBrush content.

GetCurrentValueAsFrozen()

Tworzy zamrożoną kopię Freezable przy użyciu bieżących wartości właściwości.Creates a frozen copy of the Freezable using current property values. Ponieważ kopia jest zamrożona, wszelkie zamrożone obiekty podrzędne są kopiowane przez odwołanie.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Odziedziczone po Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Sprawia, że bieżące wystąpienie jest zablokowanym klonem określonego Freezable.Makes the current instance a frozen clone of the specified Freezable. Jeśli obiekt ma animowane właściwości zależności, ich bieżące wartości animowane są kopiowane.If the object has animated dependency properties, their current animated values are copied.

(Odziedziczone po Freezable)
GetHashCode()

Pobiera kod skrótu dla tego DependencyObject.Gets a hash code for this DependencyObject.

(Odziedziczone po DependencyObject)
GetLocalValueEnumerator()

Tworzy wyspecjalizowany moduł wyliczający służący do określania, które właściwości zależności mają lokalnie ustawione wartości na tej DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności w tym wystąpieniu DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)

Ponowna ocenuje wartość efektywną dla określonej właściwości zależności.Re-evaluates the effective value for the specified dependency property.

(Odziedziczone po DependencyObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnChanged()

Wywoływana, gdy bieżący obiekt Freezable jest modyfikowany.Called when the current Freezable object is modified.

(Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Zapewnia, że DependencyObjectType dla elementu członkowskiego danych, który został właśnie ustawiony, są ustanowione odpowiednie wskaźniki kontekstu.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) i nie jest przeznaczony do użycia bezpośrednio w kodzie.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Odziedziczone po Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Przesłania DependencyObject implementację OnPropertyChanged(DependencyPropertyChangedEventArgs), aby wywołać także wszystkie procedury obsługi Changed w odpowiedzi na zmianę właściwości zależności typu Freezable.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Odziedziczone po Freezable)
ReadLocalValue(DependencyProperty)

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.Returns the local value of a dependency property, if it exists.

(Odziedziczone po DependencyObject)
ReadPreamble()

Zapewnia dostęp do Freezable z prawidłowego wątku.Ensures that the Freezable is being accessed from a valid thread. Dziedziczenia Freezable muszą wywoływać tę metodę na początku każdego interfejsu API, który odczytuje składowe danych, które nie są właściwościami zależności.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Odziedziczone po Freezable)
SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany jego źródła wartości.Sets the value of a dependency property without changing its value source.

(Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności, określoną za pomocą identyfikatora właściwości zależności.Sets the local value of a dependency property, specified by its dependency property identifier.

(Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu, określoną przez DependencyPropertyKey identyfikator właściwości zależności.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Odziedziczone po DependencyObject)
ToString()

Zwraca reprezentację Brushciągu.Return string representation of this Brush.

(Odziedziczone po Brush)
ToString(IFormatProvider)

Tworzy ciąg reprezentujący ten obiekt na podstawie określonych informacji o formatowaniu specyficznych dla kultury.Creates a string representation of this object based on the specified culture-specific formatting information.

(Odziedziczone po Brush)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
WritePostscript()

Podnosi zdarzenie Changed dla Freezable i wywołuje jego metodę OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Klasy, które pochodzą z Freezable powinny wywołać tę metodę na końcu każdego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności.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.

(Odziedziczone po Freezable)
WritePreamble()

Sprawdza, czy Freezable nie jest zamrożona i czy jest dostępny z prawidłowego kontekstu wątków.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. dziedziczenia Freezable powinny wywołać tę metodę na początku każdego interfejsu API, który zapisuje dane w elementach członkowskich, które nie są właściwościami zależności.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Odziedziczone po Freezable)

Zdarzenia

Changed

Występuje, gdy Freezable lub obiekt, który zawiera, jest modyfikowany.Occurs when the Freezable or an object it contains is modified.

(Odziedziczone po Freezable)

Jawne implementacje interfejsu

IFormattable.ToString(String, IFormatProvider)

Formatuje wartość bieżącego wystąpienia w określonym formacie.Formats the value of the current instance using the specified format.

(Odziedziczone po Brush)

Dotyczy

Zobacz też