TileBrush Clase

Definición

Describe una manera de pintar una región utilizando uno o varios mosaicos.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
Herencia
Derivado

Comentarios

Las clases derivadas de TileBrush definen el contenido de los mosaicos que se utilizan para pintar una región.The derived classes of TileBrush define the contents of the tiles that you use to paint a region. Por ejemplo, use la clase ImageBrush para pintar un área con una imagen.For example, use the ImageBrush class to paint an area by using an image.

Use un TileBrush para controlar cómo se pinta un área.Use a TileBrush to control how you paint an area. Por ejemplo, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) proporciona varios tipos de pinceles:For example, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) provides several types of brushes:

Cuando use el TileBrush para pintar un área, en lugar de pintar un área con una sola imagen ajustada, puede pintar un área con una serie de mosaicos de imagen que crean un patrón.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.

Cuando se pinta un área con un TileBrush, se usan tres componentes: contenido, mosaicos y el área de salida.When you paint an area by using a TileBrush, you use three components: content, tiles, and the output area. En las ilustraciones siguientes se muestra cómo se relacionan entre sí estos tres componentes TileBrush.The following illustrations show how these three TileBrush components relate to each other.

Componentes de TileBrushTileBrush components
Componentes de TileBrush con un solo mosaicoComponents of a TileBrush with a single tile

Componentes de un objeto TileBrush en mosaicoComponents of a tiled TileBrush
Componentes de TileBrush con un valor de TileMode de TileComponents of a TileBrush with a TileMode of Tile

Contenido: Un TileBrush puede tener distintos tipos de contenido:Content: A TileBrush can have different types of content:

Puede especificar la posición y las dimensiones del contenido de TileBrush mediante la propiedad Viewbox.You can specify the position and dimensions of TileBrush content by using the Viewbox property.

Mosaicos: Un TileBrush genera uno o varios mosaicos.Tiles: A TileBrush produces one or more tiles. De forma predeterminada, el contenido del pincel se ajusta para rellenar un solo mosaico y ese mosaico se ajusta para rellenar el área de salida.By default, the content of the brush is stretched to fill a single tile and that tile is stretched to fill the output area. La propiedad Viewport se utiliza para especificar el tamaño y la posición del mosaico base para el TileBrush.The Viewport property is used to specify the size and position of the base tile for the TileBrush. La propiedad ViewportUnits determina si el tamaño y la posición del Viewport son relativos al área de salida (comportamiento predeterminado) o si son valores absolutos.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.

Área de salida: El área de salida es el área que pinta el pincel, como el Fill de un Ellipse o el @no__t 2 de un 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.

Para obtener más información sobre la clase TileBrush, vea pintar con imágenes, dibujos y objetos visuales .For more information about the TileBrush class, see Painting with Images, Drawings, and Visuals .

Características de los objetos FreezableFreezable Features

Un TileBrush es un tipo Freezable.A TileBrush is a Freezable type. Para obtener información sobre las características de @no__t 0, como la inmovilización y la clonación, vea información general sobre objetos Freezable.For information about Freezable features, such as freezing and cloning, see the Freezable Objects Overview.

Notas a los implementadores

Cuando herede de la clase TileBrush, debe reemplazar el método CreateInstanceCore().When you inherit from the TileBrush class, you must override the CreateInstanceCore() method. Para obtener más información sobre la herencia de tipos Freezable, vea la información general sobre objetos Freezable.For more information about inheriting from Freezable types, see the Freezable Objects Overview.

Constructores

TileBrush()

Proporciona la inicialización de los valores de clase base cuando lo invoca el constructor de una clase derivada.Provides initialization for base class values when called by the constructor of a derived class.

Campos

AlignmentXProperty

Identifica la propiedad de dependencia AlignmentX.Identifies the AlignmentX dependency property.

AlignmentYProperty

Identifica la propiedad de dependencia AlignmentY.Identifies the AlignmentY dependency property.

StretchProperty

Identifica la propiedad de dependencia Stretch.Identifies the Stretch dependency property.

TileModeProperty

Identifica la propiedad de dependencia TileMode.Identifies the TileMode dependency property.

ViewboxProperty

Identifica la propiedad de dependencia Viewbox.Identifies the Viewbox dependency property.

ViewboxUnitsProperty

Identifica la propiedad de dependencia ViewboxUnits.Identifies the ViewboxUnits dependency property.

ViewportProperty

Identifica la propiedad de dependencia Viewport.Identifies the Viewport dependency property.

ViewportUnitsProperty

Identifica la propiedad de dependencia ViewportUnits.Identifies the ViewportUnits dependency property.

Propiedades

AlignmentX

Obtiene o establece la alineación horizontal del contenido del mosaico base TileBrush.Gets or sets the horizontal alignment of content in the TileBrush base tile.

AlignmentY

Obtiene o establece la alineación vertical del contenido en el mosaico base TileBrush.Gets or sets the vertical alignment of content in the TileBrush base tile.

CanFreeze

Obtiene un valor que indica si el objeto se puede convertir en no modificable.Gets a value that indicates whether the object can be made unmodifiable.

(Heredado de Freezable)
DependencyObjectType

Obtiene el objeto DependencyObjectType que ajusta el tipo CLRCLR de esta instancia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Heredado de DependencyObject)
Dispatcher

Obtiene el objeto Dispatcher al que está asociado DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Heredado de DispatcherObject)
HasAnimatedProperties

Obtiene un valor que indica si uno o más objetos AnimationClock se asocian a cualquiera de las propiedades de dependencia de este objeto.Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(Heredado de Animatable)
IsFrozen

Obtiene un valor que indica si el objeto se puede modificar actualmente.Gets a value that indicates whether the object is currently modifiable.

(Heredado de Freezable)
IsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Heredado de DependencyObject)
Opacity

Obtiene o establece el grado de opacidad de Brush.Gets or sets the degree of opacity of a Brush.

(Heredado de Brush)
RelativeTransform

Obtiene o establece la transformación que se aplica al pincel mediante coordenadas relativas.Gets or sets the transformation that is applied to the brush using relative coordinates.

(Heredado de Brush)
Stretch

Obtiene o establece un valor que especifica cómo se expande el contenido de este TileBrush para ajustarse a sus mosaicos.Gets or sets a value that specifies how the content of this TileBrush stretches to fit its tiles.

TileMode

Obtiene o establece un valor que especifica cómo TileBrush rellena el área que se está pintando si el mosaico base es menor que el área de salida.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

Obtiene o establece la transformación que se aplica al pincel.Gets or sets the transformation that is applied to the brush. Esta transformación se aplica después de haber asignado y colocado la salida del pincel.This transformation is applied after the brush's output has been mapped and positioned.

(Heredado de Brush)
Viewbox

Obtiene o establece la posición y las dimensiones del contenido de un mosaico de TileBrush.Gets or sets the position and dimensions of the content in a TileBrush tile.

ViewboxUnits

Obtiene o establece un valor que especifica si el valor de Viewbox es relativo al rectángulo de selección del contenido de TileBrush o si el valor es absoluto.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

Obtiene o establece la posición y las dimensiones del mosaico base de TileBrush.Gets or sets the position and dimensions of the base tile for a TileBrush.

ViewportUnits

Obtiene o establece una enumeración BrushMappingMode que especifica si el valor de Viewport, que indica el tamaño y la posición del mosaico base de TileBrush, es relativo al tamaño del área de salida.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.

Métodos

ApplyAnimationClock(DependencyProperty, AnimationClock)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(Heredado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado.If the property is already animated, the specified HandoffBehavior is used.

(Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Aplica una animación a la DependencyProperty especificada.Applies an animation to the specified DependencyProperty. La animación se inicia al representar el siguiente fotograma.The animation is started when the next frame is rendered. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Aplica una animación a la DependencyProperty especificada.Applies an animation to the specified DependencyProperty. La animación se inicia al representar el siguiente fotograma.The animation is started when the next frame is rendered. Si la propiedad especificada ya está animada, se usa el objeto HandoffBehavior especificado.If the specified property is already animated, the specified HandoffBehavior is used.

(Heredado de Animatable)
CheckAccess()

Determina si el subproceso de la llamada tiene acceso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Heredado de DispatcherObject)
ClearValue(DependencyProperty)

Borra el valor local de una propiedad.Clears the local value of a property. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de solo lectura.Clears the local value of a read-only property. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Heredado de DependencyObject)
Clone()

Crea una copia modificable de esta TileBrush y hace copias en profundidad de sus valores.Creates a modifiable copy of this TileBrush by making deep copies of its values.

CloneCore(Freezable)

Convierte la instancia en un clon (copia en profundidad) de la clase Freezable especificada con valores de propiedad base (no animadas).Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Heredado de Freezable)
CloneCurrentValue()

Crea una copia modificable de este objeto TileBrush y hace copias en profundidad de sus valores.Creates a modifiable copy of this TileBrush object by making deep copies of its values. Este método no copia referencias de recursos, enlaces de datos o animaciones, pero sí copia sus valores actuales.This method does not copy resource references, data bindings, or animations, although it does copy their current values.

CloneCurrentValueCore(Freezable)

Convierte esta instancia en un clon modificable (copia en profundidad) del Freezable especificado mediante los valores de propiedad actuales.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Heredado de Freezable)
CoerceValue(DependencyProperty)

Convierte el valor de la propiedad de dependencia especificada.Coerces the value of the specified dependency property. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Heredado de DependencyObject)
CreateInstance()

Inicializa una nueva instancia de la clase Freezable.Initializes a new instance of the Freezable class.

(Heredado de Freezable)
CreateInstanceCore()

Cuando se implementa en una clase derivada, crea una nueva instancia de la clase Freezable derivada.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Heredado de Freezable)
Equals(Object)

Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Heredado de DependencyObject)
Freeze()

Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Heredado de Freezable)
FreezeCore(Boolean)

Convierte este objeto Animatable en no modificable o determina si se puede convertir en no modificable.Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(Heredado de Animatable)
GetAnimationBaseValue(DependencyProperty)

Devuelve el valor no animado del objeto DependencyProperty especificado.Returns the non-animated value of the specified DependencyProperty.

(Heredado de Animatable)
GetAsFrozen()

Crea una copia inmovilizada de Freezable, con los valores de propiedades base (no animadas).Creates a frozen copy of the Freezable, using base (non-animated) property values. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Heredado de Freezable)
GetAsFrozenCore(Freezable)

Convierte la instancia en un clon inmovilizado de la clase Freezable especificada con los valores de propiedades base (no animadas).Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Heredado de Freezable)
GetContentBounds(Rect)

Obtiene los límites actuales del contenido de TileBrush.Obtains the current bounds of the TileBrush content.

GetCurrentValueAsFrozen()

Crea una copia inmovilizada de Freezable con los valores de propiedad actuales.Creates a frozen copy of the Freezable using current property values. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Convierte la instancia actual en un clon inmovilizado de la clase Freezable especificada.Makes the current instance a frozen clone of the specified Freezable. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales.If the object has animated dependency properties, their current animated values are copied.

(Heredado de Freezable)
GetHashCode()

Obtiene el código hash de DependencyObject.Gets a hash code for this DependencyObject.

(Heredado de DependencyObject)
GetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Heredado de DependencyObject)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada.Re-evaluates the effective value for the specified dependency property.

(Heredado de DependencyObject)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnChanged()

Se le llama cuando el objeto Freezable actual se modifica.Called when the current Freezable object is modified.

(Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Se asegura de que se establecen los punteros contextuales adecuados para un miembro de datos DependencyObjectType que se acaba de establecer.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Este miembro es compatible con la infraestructura de Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) y no está diseñado para utilizarse directamente desde el código.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Reemplaza la implementación DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también cualquier controlador Changed en respuesta a una propiedad de dependencia cambiante de tipo Freezable.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Heredado de Freezable)
ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.Returns the local value of a dependency property, if it exists.

(Heredado de DependencyObject)
ReadPreamble()

Se asegura de que se tiene acceso a Freezable desde un subproceso válido.Ensures that the Freezable is being accessed from a valid thread. Los herederos de Freezable deben llamar a este método al inicio de las API que leen miembros de datos que no son propiedades de dependencia.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Heredado de Freezable)
SetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar el origen de su valor.Sets the value of a dependency property without changing its value source.

(Heredado de DependencyObject)
SetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia.Sets the local value of a dependency property, specified by its dependency property identifier.

(Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia suministrada.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Heredado de DependencyObject)
ToString()

Devuelve una representación en forma de cadena de Brush.Return string representation of this Brush.

(Heredado de Brush)
ToString(IFormatProvider)

Crea una representación de cadena de este objeto con la información de formato específica de la referencia cultural especificada.Creates a string representation of this object based on the specified culture-specific formatting information.

(Heredado de Brush)
VerifyAccess()

Exige que el subproceso de la llamada tenga acceso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Heredado de DispatcherObject)
WritePostscript()

Genera el evento Changed para Freezable e invoca su método OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no estén almacenados como propiedades de dependencia.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.

(Heredado de Freezable)
WritePreamble()

Comprueba que no se inmovilice Freezable y que se tiene acceso desde un contexto de subproceso válido.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Los herederos de Freezable deben llamar a este método al inicio de las API que escriben en miembros de datos que no son propiedades de dependencia.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Heredado de Freezable)

Eventos

Changed

Se produce cuando se modifican la clase Freezable o un objeto que la contiene.Occurs when the Freezable or an object it contains is modified.

(Heredado de Freezable)

Implementaciones de interfaz explícitas

IFormattable.ToString(String, IFormatProvider)

Aplica formato al valor de la instancia actual utilizando el formato especificado.Formats the value of the current instance using the specified format.

(Heredado de Brush)

Se aplica a

Consulte también: