Visual Visual Visual Visual Class

Definición

Proporciona la compatibilidad de representación de WPF, que incluye la prueba de posicionamiento, la transformación de coordinación y los cálculos del rectángulo de selección.Provides rendering support in WPF, which includes hit testing, coordinate transformation, and bounding box calculations.

public ref class Visual abstract : System::Windows::DependencyObject
public abstract class Visual : System.Windows.DependencyObject
type Visual = class
    inherit DependencyObject
    interface DUCE.IResource
Public MustInherit Class Visual
Inherits DependencyObject
Herencia
Derivado

Comentarios

El Visual clase es la abstracción básica desde la que cada FrameworkElement se deriva el objeto.The Visual class is the basic abstraction from which every FrameworkElement object derives. También sirve como punto de entrada para escribir nuevos controles WPFWPFy en muchos sentidos puede considerarse como un equivalente de un identificador de ventana (HWND) en el Win32Win32 modelo de aplicación.It also serves as the entry point for writing new controls in WPFWPF, and in many ways can be thought of as an equivalent of a window handle (HWND) in the Win32Win32 application model.

El Visual objeto es un núcleo WPFWPF objeto, cuyo rol principal es proporcionar compatibilidad con la representación.The Visual object is a core WPFWPF object, whose primary role is to provide rendering support. Controles de interfaz de usuario, como Button y TextBox, derivan de la Visual clase y usar el Visual define las propiedades para conservar sus datos de representación.User interface controls, such as Button and TextBox, derive from the Visual class, and use the Visual defined properties for persisting their rendering data. La Visual objeto proporciona compatibilidad para lo siguiente:The Visual object provides support for the following:

  • Presentación de salida: representación persistente, serializa el contenido de dibujo de un objeto visual.Output display: Rendering the persisted, serialized drawing content of a visual.

  • Transformaciones: realizar transformaciones en un objeto visual.Transformations: Performing transformations on a visual.

  • Recorte: proporcionar soporte para una zona de recorte de un objeto visual.Clipping: Providing clipping region support for a visual.

  • La prueba de posicionamiento: Determinar si una coordenada especificada (punto) o geometría está dentro de los límites de un objeto visual.Hit testing: Determining whether a specified coordinate (point) or geometry is contained within the bounds of a visual.

  • Cálculos de rectángulo de selección: determinar el rectángulo delimitador de un objeto visual.Bounding box calculations: Determining the bounding rectangle of a visual.

Arquitectónicamente, la Visual objeto no incluye compatibilidad con otros requisitos de desarrollo de aplicaciones / WPFWPF características que no están relacionadas con inmediatamente para su procesamiento, como la siguiente:Architecturally, the Visual object does not include support for other application development requirements / WPFWPF features that are not immediately related to its rendering, such as the following:

  • Control de eventosEvent handling

  • DiseñoLayout

  • EstilosStyles

  • Enlace de datosData binding

  • GlobalizaciónGlobalization

Visual se proporciona como una clase abstracta pública desde el que más se pueden derivar clases.Visual is provided as a public abstract class from which further classes can be derived. La siguiente ilustración muestra la jerarquía de los objetos visuales existentes que se definen en el WPFWPF arquitectura.The following illustration shows the hierarchy of the existing visual objects that are defined in the WPFWPF architecture.

Diagrama de clases derivadas del objeto VisualDiagram of classes derived from the Visual object
Jerarquía de clase VisualVisual class hierarchy

En algunos casos, los miembros que se definen como protegido en Visual se exponen como miembros más fácilmente accesibles con nombres similares en la clase derivada UIElement clase.In some cases, members that are defined as protected in Visual are exposed as more readily accessible members with similar names in the derived UIElement class.

Para más información, consulte Información general sobre la representación de gráficos en WPF.For more information, see WPF Graphics Rendering Overview.

Un Visual tiene un número limitado de niveles.A Visual has a limited number of levels. En versiones anteriores de .NET Framework, esta profundidad máxima era 255.In previous versions of the .NET Framework, this maximum depth was 255. Este límite no es adecuado para algunos diseños que tienen muchos niveles en el árbol visual.This limit is inadequate for some layouts that have many levels in the visual tree.

En .NET Framework 4.NET Framework 4, la profundidad máxima de un Visual es 2047, que permite que los árboles visuales mucho más profundos.In .NET Framework 4.NET Framework 4, the maximum depth of a Visual is 2047, which enables much deeper visual trees. En la mayoría de las aplicaciones, no hay suficiente espacio de pila para atravesar tantos niveles, y el resultado es un StackOverflowException durante el diseño.In most applications, there is not enough stack space to traverse so many levels, and the result is a StackOverflowException during layout. Para el tamaño de pila predeterminado, esta excepción se produce normalmente cuando la profundidad de árbol es de aproximadamente 800, que corresponde a aproximadamente 190 anidados TreeViewItem objetos.For the default stack size, this exception is usually thrown when the tree depth is approximately 800, which corresponds to about 190 nested TreeViewItem objects.

Si se produce esta excepción la aplicación y debe tener un árbol visual más profundo, puede aumentar el tamaño de la pila de la aplicación.If this exception is thrown by your application and you need to have a deeper visual tree, you can increase the application's stack size. Puede aumentar el tamaño de la pila mediante la opción /STACK en tiempo de compilación o mediante la utilidad EDITBIN.You can increase the size of the stack by using the /STACK option at compile time or by using the EDITBIN utility. Aumentar el tamaño de pila puede afectar al rendimiento de la aplicación.Increasing the stack size may affect your application's performance. Para obtener más información, consulte asignaciones de la pila y opciones de EDITBIN.For more information, see Stack Allocations and EDITBIN Options.

Constructores

Visual() Visual() Visual() Visual()

Proporciona la inicialización base de los objetos derivados de la clase Visual.Provides the base initialization for objects derived from the Visual class.

Propiedades

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

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

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

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

(Inherited from DispatcherObject)
IsSealed IsSealed IsSealed 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).

(Inherited from DependencyObject)
VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect

Obtiene o establece el valor de BitmapEffect para Visual.Gets or sets the BitmapEffect value for the Visual.

VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput

Obtiene o establece el valor de BitmapEffectInput para Visual.Gets or sets the BitmapEffectInput value for the Visual.

VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode

Obtiene o establece el objeto BitmapScalingMode para Visual.Gets or sets the BitmapScalingMode for the Visual.

VisualCacheMode VisualCacheMode VisualCacheMode VisualCacheMode

Obtiene o establece una representación en caché del objeto Visual.Gets or sets a cached representation of the Visual.

VisualChildrenCount VisualChildrenCount VisualChildrenCount VisualChildrenCount

Obtiene el número de elementos secundarios del objeto Visual.Gets the number of child elements for the Visual.

VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint

Obtiene o establece el valor de ClearTypeHint que determina cómo se presenta ClearType en el objeto Visual.Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

VisualClip VisualClip VisualClip VisualClip

Obtiene o establece la región de recorte del objeto Visual como valor de Geometry.Gets or sets the clip region of the Visual as a Geometry value.

VisualEdgeMode VisualEdgeMode VisualEdgeMode VisualEdgeMode

Obtiene o establece el modo de borde del objeto Visual como valor de EdgeMode.Gets or sets the edge mode of the Visual as an EdgeMode value.

VisualEffect VisualEffect VisualEffect VisualEffect

Obtiene o establece el efecto de imagen que se va a aplicar a Visual.Gets or sets the bitmap effect to apply to the Visual.

VisualOffset VisualOffset VisualOffset VisualOffset

Obtiene o establece el valor de desplazamiento del objeto visual.Gets or sets the offset value of the visual object.

VisualOpacity VisualOpacity VisualOpacity VisualOpacity

Obtiene o establece la opacidad del objeto Visual.Gets or sets the opacity of the Visual.

VisualOpacityMask VisualOpacityMask VisualOpacityMask VisualOpacityMask

Obtiene o establece el valor de Brush que representa la máscara de opacidad del objeto Visual.Gets or sets the Brush value that represents the opacity mask of the Visual.

VisualParent VisualParent VisualParent VisualParent

Obtiene el objeto primario del árbol visual del objeto visual.Gets the visual tree parent of the visual object.

VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip

Obtiene o establece un área de recorte desplazable del objeto Visual.Gets or sets a clipped scrollable area for the Visual.

VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode

Obtiene o establece el TextHintingMode de Visual.Gets or sets the TextHintingMode of the Visual.

VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode

Obtiene o establece el TextRenderingMode de Visual.Gets or sets the TextRenderingMode of the Visual.

VisualTransform VisualTransform VisualTransform VisualTransform

Obtiene o establece el valor de Transform para Visual.Gets or sets the Transform value for the Visual.

VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines

Obtiene o establece la colección de instrucciones de la coordenada x (vertical).Gets or sets the x-coordinate (vertical) guideline collection.

VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines

Obtiene o establece la colección de instrucciones de la coordenada y (horizontal).Gets or sets the y-coordinate (horizontal) guideline collection.

Métodos

AddVisualChild(Visual) AddVisualChild(Visual) AddVisualChild(Visual) AddVisualChild(Visual)

Define la relación primario-secundario entre dos objetos visuales.Defines the parent-child relationship between two visuals.

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

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

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) 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.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) 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.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) 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.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) 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.

(Inherited from DependencyObject)
FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject)

Devuelve el antecesor común de dos objetos visuales.Returns the common ancestor of two visual objects.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() 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.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) 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.

(Inherited from DependencyObject)
GetVisualChild(Int32) GetVisualChild(Int32) GetVisualChild(Int32) GetVisualChild(Int32)

Devuelve el objeto Visual especificado de la colección VisualCollection primaria.Returns the specified Visual in the parent VisualCollection.

HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters)

Determina si un valor geométrico está dentro de los límites del objeto visual.Determines whether a geometry value is within the bounds of the visual object.

HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters)

Determina si un valor de coordenada de punto está dentro de los límites del objeto visual.Determines whether a point coordinate value is within the bounds of the visual object.

InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

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

(Inherited from DependencyObject)
IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject)

Determina si el objeto visual es un antecesor del objeto visual descendiente.Determines whether the visual object is an ancestor of the descendant visual object.

IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject)

Determina si el objeto visual es un descendiente del objeto visual antecesor.Determines whether the visual object is a descendant of the ancestor visual object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale)

Llamado cuando cambia el valor de PPP en el que este cuadro de texto enriquecido se representa.Called when the DPI at which this View is rendered changes.

OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Se informa de la propiedad de dependencia concreta que cambió en los datos de evento.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject)

Se le llama cuando se modifica la colección VisualCollection del objeto visual.Called when the VisualCollection of the visual object is modified.

OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject)

Se le llama cuando se cambia el objeto primario del objeto visual.Called when the parent of the visual object is changed.

PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point)

Convierte un objeto Point en coordenadas de pantalla en un objeto Point que representa el sistema de coordenadas actual de Visual.Converts a Point in screen coordinates into a Point that represents the current coordinate system of the Visual.

PointToScreen(Point) PointToScreen(Point) PointToScreen(Point) PointToScreen(Point)

Convierte un objeto Point que representa el sistema de coordenadas actual del objeto Visual en un objeto Point de coordenadas de pantalla.Converts a Point that represents the current coordinate system of the Visual into a Point in screen coordinates.

ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

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

(Inherited from DependencyObject)
RemoveVisualChild(Visual) RemoveVisualChild(Visual) RemoveVisualChild(Visual) RemoveVisualChild(Visual)

Quita la relación primario-secundario entre dos objetos visuales.Removes the parent-child relationship between two visuals.

SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

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

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

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

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) 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.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

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

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual)

Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el antecesor del objeto Visual especificado del objeto visual.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual ancestor of the visual object.

TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D)

Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el antecesor del objeto Visual3D especificado del objeto visual.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual3D ancestor of the visual object.

TransformToDescendant(Visual) TransformToDescendant(Visual) TransformToDescendant(Visual) TransformToDescendant(Visual)

Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el descendiente del objeto visual especificado.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object descendant.

TransformToVisual(Visual) TransformToVisual(Visual) TransformToVisual(Visual) TransformToVisual(Visual)

Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el objeto visual especificado.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

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

(Inherited from DispatcherObject)

Se aplica a

Consulte también: