Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Visual (Clase)

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.

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

public abstract class Visual : DependencyObject

El tipo Visual expone los siguientes miembros.

  NombreDescripción
Método protegidoVisualProporciona la inicialización base de los objetos derivados de la clase Visual.
Arriba

  NombreDescripción
Propiedad públicaDependencyObjectTypeObtiene DependencyObjectType que contiene el tipo de CLR de esta instancia.  (Se hereda de DependencyObject).
Propiedad públicaDispatcherObtiene Dispatcher que este DispatcherObject es asociado. (Se hereda de DispatcherObject).
Propiedad públicaIsSealedObtiene un valor que indica si esta instancia está sellada actualmente (solo lectura). (Se hereda de DependencyObject).
Propiedad protegidaVisualBitmapEffect Obsoleto. Obtiene o establece el valor de BitmapEffect para Visual.
Propiedad protegidaVisualBitmapEffectInput Obsoleto. Obtiene o establece el valor de BitmapEffectInput para Visual.
Propiedad protegidaVisualBitmapScalingModeObtiene o establece BitmapScalingMode para el objeto Visual.
Propiedad protegidaVisualCacheModeObtiene o establece una representación en caché del objeto Visual.
Propiedad protegidaVisualChildrenCountObtiene el número de elementos secundarios del objeto Visual.
Propiedad protegidaVisualClearTypeHintObtiene o establece el valor de ClearTypeHint que determina cómo se presenta ClearType en el objeto Visual.
Propiedad protegidaVisualClipObtiene o establece la región de recorte del objeto Visual como valor de Geometry.
Propiedad protegidaVisualEdgeModeObtiene o establece el modo de borde del objeto Visual como valor de EdgeMode.
Propiedad protegidaVisualEffectObtiene o establece el efecto de imagen que se va a aplicar al objeto Visual.
Propiedad protegidaVisualOffsetObtiene o establece el valor de desplazamiento del objeto visual.
Propiedad protegidaVisualOpacityObtiene o establece la opacidad del objeto Visual.
Propiedad protegidaVisualOpacityMaskObtiene o establece el valor de Brush que representa la máscara de opacidad del objeto Visual.
Propiedad protegidaVisualParentObtiene el objeto primario del árbol visual del objeto visual.
Propiedad protegidaVisualScrollableAreaClipObtiene o establece un área de recorte desplazable del objeto Visual.
Propiedad protegidaVisualTextHintingModeObtiene o establece TextHintingMode de Visual.
Propiedad protegidaVisualTextRenderingModeObtiene o establece TextRenderingMode de Visual.
Propiedad protegidaVisualTransformObtiene o establece el valor de Transform para Visual.
Propiedad protegidaVisualXSnappingGuidelinesObtiene o establece la colección de instrucciones de la coordenada x (vertical).
Propiedad protegidaVisualYSnappingGuidelinesObtiene o establece la colección de instrucciones de la coordenada y (horizontal).
Arriba

  NombreDescripción
Método protegidoAddVisualChildDefine la relación primario-secundario entre dos objetos visuales.
Método públicoCheckAccessdetermina si el subproceso de la llamada tiene acceso a este DispatcherObject. (Se hereda de DispatcherObject).
Método públicoClearValue(DependencyProperty)borra el valor local de una propiedad. La propiedad que se borrará se especifica mediante un identificador de DependencyProperty . (Se hereda de DependencyObject).
Método públicoClearValue(DependencyPropertyKey)borra el valor local de una propiedad de sólo lectura. la propiedad que se borrará es especificada por DependencyPropertyKey. (Se hereda de DependencyObject).
Método públicoCoerceValuefuerza el valor de propiedad de dependenciaespecificado. Esto se logra a cualquier función de CoerceValueCallback especificada en los metadatos de propiedad para la propiedad de dependencia tal como existe en DependencyObjectque llama. (Se hereda de DependencyObject).
Método públicoEqualsdetermina si DependencyObject proporcionado es equivalente a DependencyObjectactual. (Se hereda de DependencyObject).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFindCommonVisualAncestorDevuelve el antecesor común de dos objetos visuales.
Método públicoGetHashCodeobtiene código hash para este DependencyObject. (Se hereda de DependencyObject).
Método públicoGetLocalValueEnumeratorCrea un enumerador especializado para determinar qué propiedades de dependencia localmente han establecido valores en este DependencyObject. (Se hereda de DependencyObject).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoGetValuedevuelve el valor efectivo actual de propiedad de dependencia en esta instancia de DependencyObject. (Se hereda de DependencyObject).
Método protegidoGetVisualChildDevuelve el objeto Visual especificado del objeto VisualCollection primario.
Método protegidoHitTestCore(GeometryHitTestParameters)Determina si un valor geométrico está dentro de los límites del objeto visual.
Método protegidoHitTestCore(PointHitTestParameters)Determina si un valor de coordenada de punto está dentro de los límites del objeto visual.
Método públicoInvalidatePropertyEvalúa de nuevo el valor real de la propiedad de dependencia especificada (Se hereda de DependencyObject).
Método públicoIsAncestorOfDetermina si el objeto visual es un antecesor del objeto visual descendiente.
Método públicoIsDescendantOfDetermina si el objeto visual es un descendiente del objeto visual antecesor.
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnPropertyChangedinvocado siempre que el valor efectivo de cualquier propiedad de dependencia en este DependencyObject se haya actualizado. La propiedad de dependencia concreta cambiada se muestran en los datos de evento. (Se hereda de DependencyObject).
Método protegidoOnVisualChildrenChangedSe llama cuando se modifica la colección VisualCollection del objeto visual.
Método protegidoOnVisualParentChangedSe le llama cuando se cambia el objeto primario del objeto visual.
Método públicoPointFromScreenConvierte un objeto Point en coordenadas de pantalla en un objeto Point que representa el sistema de coordenadas actual de Visual.
Método públicoPointToScreenConvierte un objeto Point que representa el sistema de coordenadas actual del objeto Visual en un objeto Point de coordenadas de pantalla.
Método públicoReadLocalValuedevuelve el valor local de propiedad de dependencia, si existe. (Se hereda de DependencyObject).
Método protegidoRemoveVisualChildQuita la relación primario-secundario entre dos objetos visuales.
Método públicoSetCurrentValueEstablece el valor de propiedad de dependencia sin cambiar el origen del valor. (Se hereda de DependencyObject).
Método públicoSetValue(DependencyProperty, Object)Establece el valor local de propiedad de dependencia, especificado por el identificador de propiedad de dependencia. (Se hereda de DependencyObject).
Método públicoSetValue(DependencyPropertyKey, Object)establece el valor local de un solo lectura propiedad de dependencia, especificado por el identificador de DependencyPropertyKey de la propiedad de dependencia. (Se hereda de DependencyObject).
Método protegidoShouldSerializePropertyDevuelve un valor que indica si los procesos de serialización debe serializar el valor de propiedad de dependenciaproporcionado. (Se hereda de DependencyObject).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoTransformToAncestor(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.
Método públicoTransformToAncestor(Visual3D)Devuelve una transformación que se puede usar para transformar las coordenadas del objeto Visual en el antecesor del objeto Visual3D especificado del objeto visual.
Método públicoTransformToDescendantDevuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el descendiente del objeto visual especificado.
Método públicoTransformToVisualDevuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el objeto visual especificado.
Método públicoVerifyAccessSe aplica al subproceso de llamada tiene acceso a este DispatcherObject. (Se hereda de DispatcherObject).
Arriba

La clase Visual es la abstracción básica de la que se derivan todos los objetos FrameworkElement. También actúa como punto de entrada para escribir nuevos controles en WPF y, en muchos sentidos, se puede considerar como equivalente de un identificador de ventana (HWND) del modelo de aplicaciones de Win32.

El objeto Visual es un objeto básico de WPF, cuyo rol principal es proporcionar la compatibilidad con la representación. Los controles de la interfaz de usuario, como Button y TextBox, se derivan de la clase Visual y usan las propiedades definidas de Visual para conservar los datos de representación. El objeto Visual proporciona compatibilidad con los siguientes elementos:

  • Presentación de salida: representación del contenido conservado y serializado de un elemento visual.

  • Transformaciones: ejecución de las transformaciones de un elemento visual.

  • Recorte: compatibilidad con la zona de recorte para un elemento visual.

  • Pruebas de posicionamiento: determinación de si una coordenada (punto) o geometría especificadas están contenidas en los límites de un elemento visual.

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

Arquitectónicamente, el objeto Visual no incluye compatibilidad con los requisitos de desarrollo de otras aplicaciones o las características de WPF que no se relacionen inmediatamente con su representación, por ejemplo:

  • Control de eventos

  • Diseño

  • Estilos

  • Enlace de datos

  • Globalización

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

Jerarquía de la clase Visual

Diagrama de clases derivadas del objeto Visual

En algunos casos, los miembros que se definen como protegidos en Visual se exponen como miembros cuya accesibilidad de lectura es más fácil con nombres similares en la clase UIElement derivada.

Para obtener más información, vea Información general sobre la representación de gráficos en WPF.

Un Visual tiene un número de niveles limitado. 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 Visual es 2047, lo cual habilita árboles visuales mucho más profundos. En la mayoría de las aplicaciones, no hay bastante espacio de pila para atravesar tantos niveles, y el resultado es una excepción 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 aproximadamente a 190 objetos TreeViewItem anidados.

Si su aplicación produce esta excepción y necesita tener un árbol visual más profundo, puede aumentar el tamaño de pila de la aplicación. Puede aumentar el tamaño de la pila utilizando la opción /STACK en tiempo de compilación o utilizando la utilidad EDITBIN. Aumentar el tamaño de pila puede afectar al rendimiento de su aplicación. Para obtener más información, vea Asignaciones de la pila y Opciones de EDITBIN.

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft