Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

Visual.VisualScrollableAreaClip (Propiedad)

Obtiene o establece un área de recorte desplazable del objeto Visual.

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

protected internal Nullable<Rect> VisualScrollableAreaClip { get; protected set; }

Valor de propiedad

Tipo: System.Nullable<Rect>
Rect que representa el área de recorte desplazable o null si no hay ningún área de recorte asignada.

Establezca la propiedad VisualScrollableAreaClip para habilitar el desplazamiento acelerado al representar mediante software. Esto es útil en los escenarios de representación remotos, como la ejecución en el Escritorio remoto o en una máquina virtual. Establezca esta propiedad en el elemento primario cuyos elementos secundarios se desplazarán. Establecer la propiedad VisualScrollableAreaClip no tiene ningún efecto si la representación está acelerada por hardware.

La propiedad VisualScrollableAreaClip habilita escenarios concretos y avanzados. La siguiente lista muestra las advertencias que se aplican al utilizar la propiedad VisualScrollableAreaClip.

  • El fondo del área desplazada debe ser opaco, o se producirán artefactos de desplazamiento.

  • La propiedad VisualScrollableAreaClip solo acelera el desplazamiento cuando WPF se representa en software. Por ejemplo, esta situación se produce cuando la aplicación se está ejecutando sobre el Escritorio remoto o localmente en una máquina virtual.

  • El comportamiento de desplazamiento no se modifica al representar en hardware. Para evitar diferencias en el comportamiento del desplazamiento, debería mantener la propiedad VisualScrollableAreaClip habilitada para hardware y software.

  • Las transformaciones que giran y sesgan deshabilitan el desplazamiento acelerado. Las transformaciones de escala y las translaciones horizontales o verticales por encima de la región desplazada funcionan correctamente y no deshabilitan la aceleración del desplazamiento.

  • El cambio del subárbol o la activación de partes del área desplazable para redibujar a través de la animación se comportan tal y como se espera, pero se pierde la ventaja del desplazamiento acelerado por el área redibujada. Cualquier animación que invalide el área desplazada durante el mismo fotograma en el que se produce el desplazamiento elimina la ventaja de esta optimización.

  • El rectángulo VisualScrollableAreaClip ajusta su interior a los píxeles. Por consiguiente, el tamaño ajustado del rectángulo de desplazamiento siempre es menor o igual que el tamaño que ha establecido.

  • Los desplazamientos se ajustan hacia abajo. Esto significa que la diferencia del desplazamiento ajustado anterior y el actual es siempre un número entero de píxeles.

  • Las pruebas de posicionamiento pueden tener un error de hasta en un píxel.

  • Se debería activar el redondeo del diseño, porque asegura que los bordes de las áreas desplazables y el área cliente de la ventana de límite se ajustan a los límites de los píxeles, produciendo la alineación correcta.

  • La aceleración del desplazamiento no funciona en ventanas superpuestas. Esto significa que las ventanas en las que AllowTransparency == true, window.windowstyle == none, etc.

  • La aceleración del desplazamiento no se produce durante la representación de la ventana completa.

  • La aceleración del desplazamiento no funciona cuando la ventana abarca dos monitores.

  • La aceleración del desplazamiento no funciona en presencia de destinos de representación intermedios en la cadena primaria del elemento desplazado. La siguiente lista muestra algunos de estos destinos de representación intermedios.

    • Clips

    • Efectos

    • DrawingBrushes

    • VisualBrushes

    • OpacityMasks

    • Opacidad

  • Solo puede ocurrir un único desplazamiento acelerado por fotograma. Puede haber varias áreas de desplazamiento aceleradas, pero solo una de ellas puede realizar un desplazamiento acelerado durante un fotograma. Qué área se desplaza está sin determinar.

  • La aceleración del desplazamiento admite contenido por encima del área de desplazamiento (en orden Z) que no se desplaza con el resto del contenido. El sistema calcula todas las regiones desfasadas necesarias y completa el desplazamiento acelerado, pero envía varios mapas de bits adicionales a través de la conexión para devolver la parte desplazada involuntariamente a su posición correcta en pantalla.

.NET Framework

Compatible con: 4

.NET Framework Client Profile

Compatible con: 4

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.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.
Mostrar: