Visual.VisualScrollableAreaClip Visual.VisualScrollableAreaClip Visual.VisualScrollableAreaClip Visual.VisualScrollableAreaClip Property

Definición

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

public:  property Nullable<System::Windows::Rect> VisualScrollableAreaClip {  protected public:
Nullable<System::Windows::Rect> get(); protected:
 void set(Nullable<System::Windows::Rect> value); };
public Nullable<System.Windows.Rect> VisualScrollableAreaClip { protected internal get; protected set; }
member this.VisualScrollableAreaClip : Nullable<System.Windows.Rect> with get, set
Public Property VisualScrollableAreaClip As Nullable(Of Rect)

Valor de propiedad

Rect que representa el área de recorte desplazable o null si no hay ningún área de recorte asignada.A Rect that represents the scrollable clipping area, or null if no clipping area is assigned.

Comentarios

Establezca la VisualScrollableAreaClip propiedad para habilitar el desplazamiento acelerado al representar el software.Set the VisualScrollableAreaClip property to enable accelerated scrolling when rendering in software. Esto resulta útil en escenarios de representación remota, como la ejecución a través de Escritorio remoto o la ejecución en una máquina virtual.This is useful in remote rendering scenarios, such as running over Remote Desktop or running in a virtual machine. Establezca esta propiedad en el elemento primario cuyos elementos secundarios se desplazarán.Set this property on the parent element whose children will be scrolled. El establecimiento VisualScrollableAreaClip de la propiedad no tiene ningún efecto cuando se acelera la representación del hardware.Setting the VisualScrollableAreaClip property has no effect when rendering is hardware accelerated.

La VisualScrollableAreaClip propiedad habilita escenarios específicos y avanzados.The VisualScrollableAreaClip property enables specific, advanced scenarios. En la lista siguiente se muestran las advertencias que se aplican cuando VisualScrollableAreaClip se usa la propiedad.The following list shows the caveats that apply when you use the VisualScrollableAreaClip property.

  • El fondo del área desplazada debe ser opaco o se producirán artefactos de desplazamiento.The background of the scrolled area must be opaque, or scrolling artifacts will occur.

  • La VisualScrollableAreaClip propiedad acelera el desplazamiento solo cuando WPF se representa en el software.The VisualScrollableAreaClip property accelerates scrolling only when WPF is rendering in software. Por ejemplo, esta situación se produce cuando la aplicación se ejecuta en Escritorio remoto o se ejecuta localmente en una máquina virtual.For example, this situation occurs when the application is running over Remote Desktop or running locally in a virtual machine.

  • El comportamiento de desplazamiento no se modifica al representar en hardware.The scrolling behavior is unchanged when rendering in hardware. Para evitar diferencias en el comportamiento de desplazamiento, debe mantener habilitada la VisualScrollableAreaClip propiedad para hardware y software.To prevent differences in scrolling behavior, you should keep the VisualScrollableAreaClip property enabled for both hardware and software.

  • Las transformaciones rotar y sesgar deshabilitan el desplazamiento acelerado.Rotate and skew transforms disable accelerated scrolling. Las transformaciones de escala y las traducciones horizontales o verticales sobre la región desplazada funcionan correctamente y no deshabilitan la aceleración de desplazamiento.Scale transforms and horizontal or vertical translations above the scrolled region work correctly and do not disable scrolling acceleration.

  • Cambiar el subárbol o desencadenar partes del área desplazable para volver a dibujar a través de la animación se comporta según lo esperado, pero pierde la ventaja de desplazamiento acelerado para el área redibujada.Changing the subtree or triggering parts of the scrollable area to redraw via animation behave as expected, but lose the benefit of accelerated scrolling for the redrawn area. 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.Any animation that invalidates the scrolled area during the same frame in which scrolling occurs eliminates the benefit of this optimization.

  • El VisualScrollableAreaClip rectángulo se ajusta hacia adentro y hacia los píxeles.The VisualScrollableAreaClip rectangle snaps inward to pixels. Por lo tanto, el tamaño ajustado del rectángulo de desplazamiento siempre es menor o igual que el tamaño que se ha establecido.Therefore, the snapped size of the scrolling rectangle is always less than or equal to the size you have set.

  • Desplazamiento hacia abajo de desplazamientos.Offsets snap downward. Esto significa que la diferencia entre el desplazamiento ajustado anterior y el desplazamiento ajustado actual es siempre un número entero de píxeles.This means that the difference of the previous snapped offset and current snapped offset is always an integer number of pixels.

  • Las pruebas de posicionamiento pueden desactivarse hasta un píxel.Hit tests can be off by up to a pixel.

  • Se debe activar el redondeo del diseño, ya que garantiza que los bordes de las áreas desplazables y el área cliente de la ventana de límite se ajusten a los límites de píxeles, lo que da lugar a una alineación correcta.Layout rounding should be turned on, because it ensures that the edges of scrollable areas and the boundary window client area are snapped to pixel boundaries, resulting in correct alignment.

  • La aceleración de desplazamiento no funciona en ventanas superpuestas.Scrolling acceleration does not work on layered windows. Esto significa que las ventanas en las que AllowTransparency = = true, Window. WindowStyle = = None, etc.This means windows in which AllowTransparency == true, window.windowstyle == none, and so on.

  • La aceleración de desplazamiento no se produce durante la representación de la ventana completa.Scrolling acceleration does not occur during full-window rendering.

  • La aceleración de desplazamiento no funciona cuando la ventana ocupa dos monitores.Scrolling acceleration does not work when the window straddles two monitors.

  • La aceleración de desplazamiento no funciona en presencia de destinos de representación intermedios en la cadena primaria del elemento desplazado.Scrolling acceleration does not work in the presence of intermediate render targets in the parent chain of the scrolled element. En la lista siguiente se muestran algunos de estos destinos de representación intermedios.The following list shows some of these intermediate render targets.

    • MultimediaClips

    • EfectosEffects

    • DrawingBrushesDrawingBrushes

    • VisualBrushesVisualBrushes

    • OpacityMasksOpacityMasks

    • OpacidadOpacity

  • Solo se puede producir un desplazamiento acelerado por fotograma.Only one accelerated scroll can happen per frame. Puede haber varias áreas de desplazamiento aceleradas, pero solo una de ellas puede realizar un desplazamiento acelerado durante un fotograma.There can be multiple accelerated scroll areas, but only one of them can perform an accelerated scroll during a frame. El área que se desplaza es indeterminada.Which area is scrolled is indeterminate.

  • La aceleración de desplazamiento admite el contenido sobre la región de desplazamiento (en orden z) que no se desplaza con el resto del contenido.Scrolling acceleration supports content above the scrolling region (in z-order) that is not scrolled with the rest of the content. 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 de forma no intencionada a su posición correcta en la pantalla.The system calculates all necessary dirty regions and completes the accelerated scroll, but it sends several additional bitmaps over the wire to move the unintentionally scrolled portion back to its correct position on screen.

Se aplica a