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

Définition

Obtient ou définit une zone à défilement découpée pour 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)

Valeur de propriété

Rect qui représente la zone de découpage à défilement, ou null si aucune zone de découpage n'est assignée.A Rect that represents the scrollable clipping area, or null if no clipping area is assigned.

Remarques

Définir le VisualScrollableAreaClip accélérée de propriété pour activer le défilement lors du rendu dans le logiciel.Set the VisualScrollableAreaClip property to enable accelerated scrolling when rendering in software. Cela est utile dans les scénarios de rendu à distance, par exemple en cours d’exécution sur le Bureau à distance ou en cours d’exécution sur une machine virtuelle.This is useful in remote rendering scenarios, such as running over Remote Desktop or running in a virtual machine. Définissez cette propriété sur l’élément parent dont les enfants seront défilés.Set this property on the parent element whose children will be scrolled. Définition de la VisualScrollableAreaClip propriété n’a aucun effet lorsque le rendu est l’accélération matérielle.Setting the VisualScrollableAreaClip property has no effect when rendering is hardware accelerated.

Le VisualScrollableAreaClip propriété permet des scénarios avancés spécifiques.The VisualScrollableAreaClip property enables specific, advanced scenarios. La liste suivante affiche les restrictions qui s’appliquent lorsque vous utilisez le VisualScrollableAreaClip propriété.The following list shows the caveats that apply when you use the VisualScrollableAreaClip property.

  • L’arrière-plan de la zone de défilement doit être opaque, ou les artefacts de défilement se produira.The background of the scrolled area must be opaque, or scrolling artifacts will occur.

  • Le VisualScrollableAreaClip propriété accélère le défilement uniquement lorsque WPF est rendu dans le logiciel.The VisualScrollableAreaClip property accelerates scrolling only when WPF is rendering in software. Par exemple, cette situation se produit lorsque l’application s’exécute sur le Bureau à distance ou localement sur une machine virtuelle.For example, this situation occurs when the application is running over Remote Desktop or running locally in a virtual machine.

  • Le comportement de défilement est inchangé lors du rendu dans le matériel.The scrolling behavior is unchanged when rendering in hardware. Pour empêcher les différences de comportement de défilement, vous devez conserver le VisualScrollableAreaClip propriété activée pour le matériel et logiciel.To prevent differences in scrolling behavior, you should keep the VisualScrollableAreaClip property enabled for both hardware and software.

  • Les transformations de Rotate et inclinaison désactivent le défilement accéléré.Rotate and skew transforms disable accelerated scrolling. Transformations de mise à l’échelle horizontales ou verticales des traductions au-dessus de la zone défilée fonctionnent correctement et ne pas désactiver l’accélération de défilement.Scale transforms and horizontal or vertical translations above the scrolled region work correctly and do not disable scrolling acceleration.

  • Modification de la sous-arborescence ou le déclenchement des éléments de la zone de défilement à redessiner via l’animation se comportent comme prévu, mais perdre tous les avantages du défilement accéléré pour la zone redessinée.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. Toute animation qui invalide la zone de défilement au cours de la même image dans lequel le défilement se produit élimine l’avantage de cette optimisation.Any animation that invalidates the scrolled area during the same frame in which scrolling occurs eliminates the benefit of this optimization.

  • Le VisualScrollableAreaClip rectangle s’aligne vers l’intérieur, en pixels.The VisualScrollableAreaClip rectangle snaps inward to pixels. Par conséquent, la taille du rectangle défilement alignée est toujours inférieure ou égale à la taille que vous avez défini.Therefore, the snapped size of the scrolling rectangle is always less than or equal to the size you have set.

  • L’alignement de décalages vers le bas.Offsets snap downward. Cela signifie que la différence de la précédente aligné offset et actuel est toujours un nombre entier de pixels.This means that the difference of the previous snapped offset and current snapped offset is always an integer number of pixels.

  • Tests de positionnement peuvent être décalés jusqu'à un pixel.Hit tests can be off by up to a pixel.

  • Arrondi de disposition doit être activé, car il garantit que les bords des zones de défilement et de la zone cliente de fenêtre limite sont alignées sur les limites des pixels, ce qui entraîne un alignement correct.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.

  • L’accélération du défilement ne fonctionne pas sur les fenêtres superposées.Scrolling acceleration does not work on layered windows. Cela signifie que windows lesquelles AllowTransparency == true, window.windowstyle == none et ainsi de suite.This means windows in which AllowTransparency == true, window.windowstyle == none, and so on.

  • L’accélération du défilement n’a pas lieu pendant le rendu de fenêtre complète.Scrolling acceleration does not occur during full-window rendering.

  • L’accélération du défilement ne fonctionne pas lorsque la fenêtre chevauche deux moniteurs.Scrolling acceleration does not work when the window straddles two monitors.

  • L’accélération du défilement ne fonctionne pas en présence de cibles de rendu intermédiaires dans la chaîne parent de l’élément défilé.Scrolling acceleration does not work in the presence of intermediate render targets in the parent chain of the scrolled element. La liste suivante présente que certaines de ces cibles de rendu intermédiaires.The following list shows some of these intermediate render targets.

    • ClipsClips

    • Effects (Effets)Effects

    • DrawingBrushesDrawingBrushes

    • VisualBrushesVisualBrushes

    • OpacityMasksOpacityMasks

    • OpacitéOpacity

  • Seul défilement accéléré peut se produire par frame.Only one accelerated scroll can happen per frame. Il peut y avoir plusieurs zones de défilement accélérées, mais un seul d'entre eux peut effectuer un défilement accéléré pendant un laps de.There can be multiple accelerated scroll areas, but only one of them can perform an accelerated scroll during a frame. Quelle zone de défilement est indéterminé.Which area is scrolled is indeterminate.

  • L’accélération du défilement prend en charge le contenu au-dessus de la zone de défilement ne défile pas avec le reste du contenu (dans l’ordre de plan).Scrolling acceleration supports content above the scrolling region (in z-order) that is not scrolled with the rest of the content. Le système calcule toutes les zones incorrectes et termine le défilement accéléré, mais il envoie plusieurs bitmaps supplémentaires sur le réseau pour déplacer la partie défilée involontairement à sa position correcte sur l’écran.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.

S’applique à