Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.

Traducción

Inglés

Clase VisualBrush

.NET Framework (current version)

Otras versiones

Publicado: octubre de 2016

Pinta un área con un Visual.

Espacio de nombres: System.Windows.Media
Ensamblado: PresentationCore (en PresentationCore.dll)

Jerarquía de herencia

System.Object
System.Windows.Threading.DispatcherObject
System.Windows.DependencyObject
System.Windows.Freezable
System.Windows.Media.Animation.Animatable
System.Windows.Media.Brush
System.Windows.Media.TileBrush
System.Windows.Media.VisualBrush

Sintaxis

C++

public sealed class VisualBrush : TileBrush

Constructores

	Nombre	Descripción
	VisualBrush()	Inicializa una nueva instancia de la clase VisualBrush.
	VisualBrush(Visual)	Inicializa una nueva instancia de la clase VisualBrush que contiene en el elemento Visual especificado.

Propiedades

	Nombre	Descripción
	AlignmentX	Obtiene o establece la alineación horizontal del contenido del mosaico base TileBrush.(Heredado de TileBrush).
	AlignmentY	Obtiene o establece la alineación vertical del contenido en el mosaico base TileBrush.(Heredado de TileBrush).
	AutoLayoutContent	Obtiene o establece un valor que especifica si esta VisualBrush se ejecutará el diseño de su Visual.
	CanFreeze	Obtiene un valor que indica si el objeto se puede convertir en no modificable.(Heredado de Freezable).
	DependencyObjectType	Obtiene el DependencyObjectType que ajusta el CLR tipo de esta instancia. (Heredado de DependencyObject).
	Dispatcher	Obtiene el Dispatcher Esto DispatcherObject está asociado.(Heredado de DispatcherObject).
	HasAnimatedProperties	Obtiene un valor que indica si uno o más AnimationClock objetos está asociada con cualquiera de las propiedades de dependencia de este objeto.(Heredado de Animatable).
	IsFrozen	Obtiene un valor que indica si el objeto se puede modificar actualmente.(Heredado de Freezable).
	IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (sólo lectura).(Heredado de DependencyObject).
	Opacity	Obtiene o establece el grado de opacidad de Brush.(Heredado de Brush).
	RelativeTransform	Obtiene o establece la transformación que se aplica al pincel mediante coordenadas relativas.(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.(Heredado de TileBrush).
	TileMode	Obtiene o establece un valor que especifica la forma en que un TileBrush rellena el área que se está pintando si el mosaico base es más pequeño que el área de salida.(Heredado de TileBrush).
	Transform	Obtiene o establece la transformación que se aplica al pincel. Esta transformación se aplica después de haber asignado y colocado la salida del pincel.(Heredado de Brush).
	Viewbox	Obtiene o establece la posición y las dimensiones del contenido de un icono TileBrush.(Heredado de TileBrush).
	ViewboxUnits	Obtiene o establece un valor que especifica si el valor Viewbox es relativo al cuadro de límite del contenido de TileBrush o si el valor es absoluto.(Heredado de TileBrush).
	Viewport	Obtiene o establece la posición y las dimensiones del icono base de una clase TileBrush.(Heredado de 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 icono base TileBrush, es relativo al tamaño del área de salida.(Heredado de TileBrush).
	Visual	Obtiene o establece el contenido del pincel.

Métodos

	Nombre	Descripción
	ApplyAnimationClock(DependencyProperty, AnimationClock)	Se aplica AnimationClock al valor de DependencyProperty especificado. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.(Heredado de Animatable).
	ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Se aplica AnimationClock al valor de DependencyProperty especificado. Si la propiedad ya está animada, especificado HandoffBehavior se utiliza.(Heredado de Animatable).
	BeginAnimation(DependencyProperty, AnimationTimeline)	Aplica una animación a la DependencyProperty especificada. La animación se inicia al representar el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.(Heredado de Animatable).
	BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Aplica una animación a la DependencyProperty especificada. La animación se inicia al representar el siguiente fotograma. Si la propiedad especificada ya está animada, especificado HandoffBehavior se utiliza.(Heredado de Animatable).
	CheckAccess()	Determina si el subproceso de llamada tiene acceso a este DispatcherObject.(Heredado de DispatcherObject).
	ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.(Heredado de DependencyObject).
	ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.(Heredado de DependencyObject).
	Clone()	Crea un clon modificable de este VisualBrush y hace copias en profundidad de los valores de este objeto.
	CloneCurrentValue()	Crea un clon modificable de este objeto VisualBrush y hace copias en profundidad de sus valores actuales. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sí sus valores actuales.
	CoerceValue(DependencyProperty)	Convierte el valor de la propiedad de dependencia especificada. 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.(Heredado de DependencyObject).
	Equals(Object)	Determina si un proporcionado DependencyObject es equivalente a la actual DependencyObject.(Heredado de DependencyObject).
	Freeze()	Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true.(Heredado de Freezable).
	GetAnimationBaseValue(DependencyProperty)	Devuelve el valor no animado de especificado DependencyProperty.(Heredado de Animatable).
	GetAsFrozen()	Crea una copia inmovilizada de la Freezable, con los valores de la propiedad base (no animada). Dado que la copia está inmovilizada, cualquier subobjeto inmovilizado se copia por referencia.(Heredado de Freezable).
	GetCurrentValueAsFrozen()	Crea una copia inmovilizada de la Freezable con valores de propiedad actuales. Dado que la copia está inmovilizada, cualquier subobjeto inmovilizado se copia por referencia.(Heredado de Freezable).
	GetHashCode()	Obtiene un código hash de este objeto DependencyObject.(Heredado de DependencyObject).
	GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en este DependencyObject.(Heredado de DependencyObject).
	GetType()	Obtiene el Type de la instancia actual.(Heredado de Object).
	GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.(Heredado de DependencyObject).
	InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada(Heredado de DependencyObject).
	ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe.(Heredado de DependencyObject).
	SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar el origen de su valor.(Heredado de DependencyObject).
	SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia.(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.(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.(Heredado de DependencyObject).
	ToString()	Devolver la representación de cadena de este Brush.(Heredado de Brush).
	ToString(IFormatProvider)	Crea una representación de cadena de este objeto basándose en la información de formato específica de la referencia cultural especificada.(Heredado de Brush).
	VerifyAccess()	Exige que el subproceso que realiza la llamada tiene acceso a este DispatcherObject.(Heredado de DispatcherObject).

Campos

	Nombre	Descripción
	AutoLayoutContentProperty	Identifica la propiedad de dependencia AutoLayoutContent.
	VisualProperty	Identifica la propiedad de dependencia Visual.

Eventos

	Nombre	Descripción
	Changed	Se produce cuando el Freezable o se modifica un objeto que contiene.(Heredado de Freezable).

Implementaciones de interfaz explícitas

	Nombre	Descripción
	IFormattable.ToString(String, IFormatProvider)	Da formato al valor de la instancia actual usando el formato especificado.(Heredado de Brush).

Comentarios

Hay dos maneras de especificar el Visual contenido de un VisualBrush.

Crear un nuevo Visual y utilizarla para establecer el Visual propiedad de la VisualBrush.
Usar una existente Visual, que crea una imagen duplicada del destino Visual. A continuación, puede usar el VisualBrush para crear efectos interesantes, tales como reflexiones y ampliaciones.

Al definir un nuevo Visual para un VisualBrush y que Visual es un UIElement (como un panel o control), el sistema de diseño se ejecuta en el UIElement y sus elementos secundarios cuando la AutoLayoutContent propiedad está establecida en true. Sin embargo, la raíz UIElement se queda aislado del resto del sistema; estilos, los guiones gráficos y el diseño externo no pueden atravesar este límite. Por lo tanto, debe especificar explícitamente el tamaño de la raíz UIElement, porque su único elemento primario es el VisualBrush y por lo tanto no se puede cambiar automáticamente de tamaño para el área que se pinta. Para obtener más información acerca del diseño en Windows Presentation Foundation (WPF), consulte el diseño.

Las actualizaciones al árbol visual de un VisualBrush no se propagarán si un BitmapEffect en la cadena primaria del pincel. Puede solucionar esta limitación forzando una actualización de la escena en el objeto superior del efecto. Puede llamar a InvalidateVisual o incluir una animación para forzar una actualización de la escena.

Características freezable: porque se hereda de la Freezable (clase), el VisualBrush clase proporciona varias características especiales: VisualBrush pueden declarar como objetos y compartirse entre varios objetos. Para obtener más información sobre las diferentes características proporcionadas por Freezable los objetos, vea el Freezable Objects Overview.

Nota
Un VisualBrush no se puede hacer de sólo lectura (inmovilizado) cuando su Visual propiedad se establece en cualquier valor distinto de null.