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

Establecer el VisualScrollableAreaClip acelerado de propiedad para habilitar el desplazamiento al representar en el software.Set the VisualScrollableAreaClip property to enable accelerated scrolling when rendering in software. Esto es útil en escenarios de procesamiento remoto, como la ejecución a través de escritorio remoto o que se ejecuta 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 se desplazará cuyos elementos secundarios.Set this property on the parent element whose children will be scrolled. Establecer el VisualScrollableAreaClip propiedad no tiene ningún efecto cuando representación se aceleran mediante hardware.Setting the VisualScrollableAreaClip property has no effect when rendering is hardware accelerated.

El VisualScrollableAreaClip propiedad habilita escenarios concretos y avanzados.The VisualScrollableAreaClip property enables specific, advanced scenarios. La siguiente lista muestra las advertencias que se aplican cuando se usa el VisualScrollableAreaClip 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 realizará el desplazamiento de artefactos.The background of the scrolled area must be opaque, or scrolling artifacts will occur.

  • El VisualScrollableAreaClip propiedad acelera el desplazamiento sólo cuando WPF se representa en 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 a través de escritorio remoto o que se ejecutan 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.

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

  • Transformaciones de giro y el sesgado deshabilitan desplazamiento acelerado.Rotate and skew transforms disable accelerated scrolling. Transformaciones de escala y traducciones horizontales o verticales por encima de la región desplazada funcionen correctamente y no se deshabilite la aceleración de desplazamiento.Scale transforms and horizontal or vertical translations above the scrolled region work correctly and do not disable scrolling acceleration.

  • Cambio del subárbol o activación de partes del área desplazable que vuelva a dibujar a través de la animación se comportan según lo previsto, pero pierde la ventaja del desplazamiento acelerado para el área de volver a dibujar.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 invalida el área desplazado durante el mismo período en que el desplazamiento se produce 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 ajusta su interior a píxeles.The VisualScrollableAreaClip rectangle snaps inward to pixels. Por lo tanto, el tamaño del rectángulo de desplazamiento ajustado es siempre 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.

  • Los desplazamientos se ajustan hacia abajo.Offsets snap downward. Esto significa que la diferencia de la anterior desplazamiento ajustado y 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 puede desactivar por alcanzar un píxel.Hit tests can be off by up to a pixel.

  • Redondeo del diseño debe estar activado, ya que garantiza que los bordes de las áreas desplazables y el área de cliente de la ventana de límite se ajustan a los límites de píxeles, lo que resulta en la 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 del desplazamiento no funciona en las ventanas superpuestas.Scrolling acceleration does not work on layered windows. Esto significa que windows en las que AllowTransparency == true, window.windowstyle == none y así sucesivamente.This means windows in which AllowTransparency == true, window.windowstyle == none, and so on.

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

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

  • La aceleración del 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. La lista siguiente se muestran que algunos de estos destinos de representación intermedios.The following list shows some of these intermediate render targets.

    • ClipsClips

    • EfectosEffects

    • DrawingBrushesDrawingBrushes

    • VisualBrushesVisualBrushes

    • OpacityMasksOpacityMasks

    • OpacidadOpacity

  • Puede ocurrir un único desplazamiento acelerado por fotograma.Only one accelerated scroll can happen per frame. Puede haber varias áreas de desplazamiento aceleradas, pero solo uno de ellos puede realizar un desplazamiento acelerado durante un período.There can be multiple accelerated scroll areas, but only one of them can perform an accelerated scroll during a frame. Se desplaza el área que es indeterminada.Which area is scrolled is indeterminate.

  • La aceleración del desplazamiento admite contenido por encima de la región desplazable (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 de datos sucias necesarias y completa el desplazamiento acelerado, pero envía varios mapas de bits adicionales a través del cable para mover la parte involuntariamente desplazada de vuelta a su posición correcta en 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