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 Visual

 

Publicado: octubre de 2016

Proporciona compatibilidad con la representación en WPF, que incluye visitas pruebas, transformación de coordenadas y cálculos del cuadro de límite.

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


public abstract class Visual : DependencyObject

NombreDescripción
System_CAPS_protmethodVisual()

Proporciona la inicialización de la base de objetos derivados de la Visual clase.

NombreDescripción
System_CAPS_pubpropertyDependencyObjectType

Obtiene el DependencyObjectType que ajusta el CLR tipo de esta instancia. (Heredado de DependencyObject).

System_CAPS_pubpropertyDispatcher

Obtiene el Dispatcher Esto DispatcherObject está asociado.(Heredado de DispatcherObject).

System_CAPS_pubpropertyIsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (sólo lectura).(Heredado de DependencyObject).

System_CAPS_protpropertyVisualBitmapEffect

Obsoleto. Obtiene o establece la BitmapEffect valor para el Visual.

System_CAPS_protpropertyVisualBitmapEffectInput

Obsoleto. Obtiene o establece la BitmapEffectInput valor para el Visual.

System_CAPS_protpropertyVisualBitmapScalingMode

Obtiene o establece el objeto BitmapScalingMode para Visual.

System_CAPS_protpropertyVisualCacheMode

Obtiene o establece una representación en caché de la Visual.

System_CAPS_protpropertyVisualChildrenCount

Obtiene el número de elementos secundarios de la Visual.

System_CAPS_protpropertyVisualClearTypeHint

Obtiene o establece el ClearTypeHint que determina cómo se presenta ClearType en el Visual.

System_CAPS_protpropertyVisualClip

Obtiene o establece la región de recorte de la Visual como un Geometry valor.

System_CAPS_protpropertyVisualEdgeMode

Obtiene o establece el modo de borde de la Visual como un EdgeMode valor.

System_CAPS_protpropertyVisualEffect

Obtiene o establece el efecto de mapa de bits que se aplican a la Visual.

System_CAPS_protpropertyVisualOffset

Obtiene o establece el valor de desplazamiento del objeto visual.

System_CAPS_protpropertyVisualOpacity

Obtiene o establece la opacidad de la Visual.

System_CAPS_protpropertyVisualOpacityMask

Obtiene o establece la Brush valor que representa la máscara de opacidad de la Visual.

System_CAPS_protpropertyVisualParent

Obtiene al primario del árbol visual del objeto visual.

System_CAPS_protpropertyVisualScrollableAreaClip

Obtiene o establece un área de recorte desplazable para la Visual.

System_CAPS_protpropertyVisualTextHintingMode

Obtiene o establece el TextHintingMode de Visual.

System_CAPS_protpropertyVisualTextRenderingMode

Obtiene o establece la TextRenderingMode de la Visual.

System_CAPS_protpropertyVisualTransform

Obtiene o establece la Transform valor para el Visual.

System_CAPS_protpropertyVisualXSnappingGuidelines

Obtiene o establece la colección de instrucciones de la coordenada X (vertical).

System_CAPS_protpropertyVisualYSnappingGuidelines

Obtiene o establece la colección de instrucciones de la coordenada y (horizontal).

NombreDescripción
System_CAPS_protmethodAddVisualChild(Visual)

Define la relación primario-secundario entre dos objetos visuales.

System_CAPS_pubmethodCheckAccess()

Determina si el subproceso de llamada tiene acceso a este DispatcherObject.(Heredado de DispatcherObject).

System_CAPS_pubmethodClearValue(DependencyProperty)

Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.(Heredado de DependencyObject).

System_CAPS_pubmethodClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de sólo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.(Heredado de DependencyObject).

System_CAPS_pubmethodCoerceValue(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).

System_CAPS_pubmethodEquals(Object)

Determina si un proporcionado DependencyObject es equivalente a la actual DependencyObject.(Heredado de DependencyObject).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodFindCommonVisualAncestor(DependencyObject)

Devuelve al antecesor común de dos objetos visuales.

System_CAPS_pubmethodGetHashCode()

Obtiene un código hash de este objeto DependencyObject.(Heredado de DependencyObject).

System_CAPS_pubmethodGetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en este DependencyObject.(Heredado de DependencyObject).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.(Heredado de DependencyObject).

System_CAPS_protmethodGetVisualChild(Int32)

Devuelve el Visual en el elemento primario VisualCollection.

System_CAPS_protmethodHitTestCore(GeometryHitTestParameters)

Determina si un valor geométrico está dentro de los límites del objeto visual.

System_CAPS_protmethodHitTestCore(PointHitTestParameters)

Determina si un valor de coordenada de punto está dentro de los límites del objeto visual.

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada(Heredado de DependencyObject).

System_CAPS_pubmethodIsAncestorOf(DependencyObject)

Determina si el objeto visual es un antecesor del objeto visual descendiente.

System_CAPS_pubmethodIsDescendantOf(DependencyObject)

Determina si el objeto visual es un descendiente del objeto visual antecesor.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodOnDpiChanged(DpiScale, DpiScale)

Llamado cuando cambia el valor de PPP en el que este cuadro de texto enriquecido se representa.

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos de evento.(Heredado de DependencyObject).

System_CAPS_protmethodOnVisualChildrenChanged(DependencyObject, DependencyObject)

Llamado cuando la VisualCollection del objeto visual se modifica.

System_CAPS_protmethodOnVisualParentChanged(DependencyObject)

Se llama cuando cambia el elemento primario del objeto visual.

System_CAPS_pubmethodPointFromScreen(Point)

Convierte un Point en coordenadas de pantalla en un Point que representa el actual sistema de coordenadas de la Visual.

System_CAPS_pubmethodPointToScreen(Point)

Convierte un Point que representa el actual sistema de coordenadas de la Visual en una Point en coordenadas de pantalla.

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.(Heredado de DependencyObject).

System_CAPS_protmethodRemoveVisualChild(Visual)

Quita la relación primario-secundario entre dos objetos visuales.

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar el origen de su valor.(Heredado de DependencyObject).

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia.(Heredado de DependencyObject).

System_CAPS_pubmethodSetValue(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).

System_CAPS_protmethodShouldSerializeProperty(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).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_pubmethodTransformToAncestor(Visual)

Devuelve una transformación que puede usarse para transformar las coordenadas de la Visual especificado Visual antecesor del objeto visual.

System_CAPS_pubmethodTransformToAncestor(Visual3D)

Devuelve una transformación que puede usarse para transformar las coordenadas de la Visual especificado Visual3D antecesor del objeto visual.

System_CAPS_pubmethodTransformToDescendant(Visual)

Devuelve una transformación que puede usarse para transformar las coordenadas de la Visual hasta el descendiente del objeto visual especificado.

System_CAPS_pubmethodTransformToVisual(Visual)

Devuelve una transformación que puede usarse para transformar las coordenadas de la Visual en el objeto visual especificado.

System_CAPS_pubmethodVerifyAccess()

Exige que el subproceso que realiza la llamada tiene acceso a este DispatcherObject.(Heredado de DispatcherObject).

La Visual clase es la abstracción básica desde la que cada FrameworkElement deriva del objeto. También sirve como punto de entrada para escribir nuevos controles WPF, y en muchos sentidos puede considerarse como un equivalente de un identificador de ventana (HWND) en el Win32 modelo de aplicación.

La Visual objeto es un núcleo WPF objeto, cuya función principal es proporcionar compatibilidad con la representación. Controles de interfaz de usuario, como Button y TextBox, derivan de la Visual clase y utilizar el Visual define propiedades para conservar sus datos de representación. La Visual objeto proporciona compatibilidad para los siguientes elementos:

  • Presentación de salida: representación persistente, serializa el contenido de dibujo de un objeto visual.

  • Transformaciones: Realizar transformaciones en un objeto visual.

  • Recorte: Proporcionar soporte de la región de recorte para un objeto visual.

  • Pruebas de posicionamiento: determinación de si una coordenada especificada (punto) o geometría está dentro de los límites de un objeto visual.

  • Cálculos: determinación del rectángulo delimitador de un objeto visual.

Su arquitectura, la Visual objeto no incluye compatibilidad con otros requisitos de desarrollo de aplicación / WPF características que no están relacionadas con inmediatamente para su procesamiento, como la siguiente:

  • Control de eventos

  • Diseño

  • Estilos

  • Enlace de datos

  • Globalización

Visual se proporciona como una clase abstracta pública desde la que más se pueden derivar clases. La siguiente ilustración muestra la jerarquía de los objetos visuales existentes que se definen en el WPF arquitectura.

Diagrama de clases derivadas del objeto Visual

Jerarquía de clases Visual

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 el control derivado UIElement clase.

Para obtener más información, consulte WPF Graphics Rendering Overview.

Un Visual tiene un número limitado de niveles. En versiones anteriores de .NET Framework, esta profundidad máxima era 255. Este límite es inadecuado para algunos diseños que tienen muchos niveles en el árbol visual.

En .NET Framework 4, la profundidad máxima de una Visual es 2047, lo que permite que los árboles visuales mucho más profundos. 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. Para el tamaño de pila predeterminado, esta excepción se produce normalmente cuando la profundidad del árbol es aproximadamente de 800, que corresponde a aproximadamente 190 anidados TreeViewItem objetos.

Si se produce esta excepción a la aplicación y debe tener un árbol visual más profundo, puede aumentar el tamaño de la pila de la aplicación. Puede aumentar el tamaño de la pila mediante la opción /STACK en tiempo de compilación o mediante la utilidad EDITBIN. Aumentar el tamaño de pila puede afectar al rendimiento de la aplicación. Para obtener más información, consulte Stack Allocations y EDITBIN Options.

.NET Framework
Disponible desde 3.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: