Visual.VisualScrollableAreaClip Propiedad

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

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

public:  property Nullable<System::Windows::Rect> VisualScrollableAreaClip {  protected public:
Nullable<System::Windows::Rect> get(); protected:
 void set(Nullable<System::Windows::Rect> value); };

public 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

Nullable<Rect>

Rect que representa el área de recorte desplazable o null si no hay ningún área de recorte asignada.

Comentarios

Establezca la propiedad para habilitar el VisualScrollableAreaClip desplazamiento acelerado al representar en 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. Establezca esta propiedad en el elemento primario cuyos elementos secundarios se desplazarán. Establecer la VisualScrollableAreaClip propiedad no tiene ningún efecto cuando la representación se acelera por hardware.

La VisualScrollableAreaClip propiedad habilita escenarios específicos y avanzados. En la lista siguiente se muestran las advertencias que se aplican al usar la VisualScrollableAreaClip propiedad .

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

• La VisualScrollableAreaClip propiedad acelera el desplazamiento solo cuando WPF se representa en software. Por ejemplo, esta situación se produce cuando la aplicación se ejecuta a través de Escritorio remoto o se ejecuta localmente en una máquina virtual.

• El comportamiento de desplazamiento no cambia cuando se representa en hardware. Para evitar diferencias en el comportamiento de desplazamiento, debe mantener la propiedad habilitada para el hardware y el VisualScrollableAreaClip software.

• Las transformaciones de rotación y asimetría deshabilitan el desplazamiento acelerado. Las transformaciones de escala y las traducciones horizontales o verticales por encima de la región desplazada funcionan correctamente y no deshabilitan la aceleración del desplazamiento.

• Cambiar el subárbol o desencadenar partes del área desplazable para volver 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 redibujado. Cualquier animación que invalide el área de desplazamiento durante el mismo fotograma en el que se produce el desplazamiento elimina la ventaja de esta optimización.

• El VisualScrollableAreaClip rectángulo se ajusta hacia dentro a píxeles. Por lo tanto, el tamaño ajustado del rectángulo de desplazamiento siempre es menor o igual que el tamaño que ha establecido.

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

• Las pruebas de posicionamiento pueden estar desactivadas hasta un píxel.

• El redondeo del diseño debe estar activado, ya que garantiza que los bordes de las áreas desplazables y el área cliente de la ventana de límites se ajuste a los límites de píxeles, lo que da lugar a una alineación correcta.

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

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

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

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

  • Imágenes

  • Efectos

  • DrawingBrushes

  • VisualBrushes

  • OpacidadMasks

  • Opacidad

• Solo se puede producir un 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 es indeterminada.

• La aceleración de desplazamiento admite contenido por encima de la región 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 mover la parte desplazada involuntariamente a su posición correcta en la pantalla.