Visual.VisualScrollableAreaClip Propriété

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

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

Valeur de propriété

Nullable<Rect>

Rect qui représente la zone de découpage à défilement, ou null si aucune zone de découpage n'est assignée.

Remarques

Définissez la propriété pour activer le VisualScrollableAreaClip défilement accéléré lors du rendu dans le logiciel. Cela est utile dans les scénarios de rendu à distance, tels que l’exécution sur le Bureau à distance ou l’exécution sur une machine virtuelle. Définissez cette propriété sur l’élément parent dont les enfants seront défilements. La définition de la propriété n’a aucun effet lors de l’accélération VisualScrollableAreaClip matérielle du rendu.

La VisualScrollableAreaClip propriété active des scénarios spécifiques et avancés. La liste suivante montre les avertissements qui s’appliquent lorsque vous utilisez la VisualScrollableAreaClip propriété.

• L’arrière-plan de la zone de défilement doit être opaque ou les artefacts de défilement se produisent.

• La VisualScrollableAreaClip propriété accélère le défilement uniquement lorsque WPF est rendu dans le logiciel. Par exemple, cette situation se produit lorsque l’application s’exécute sur le Bureau à distance ou s’exécute localement sur une machine virtuelle.

• Le comportement de défilement est inchangé lors du rendu dans le matériel. Pour éviter les différences de comportement de défilement, vous devez conserver la propriété activée pour le matériel et les VisualScrollableAreaClip logiciels.

• Les transformations de rotation et d’asymétrie désactivent le défilement accéléré. Les transformations de mise à l’échelle et les traductions horizontales ou verticales au-dessus de la région à défilement fonctionnent correctement et ne désactivent pas l’accélération de défilement.

• La modification de la sous-arborescence ou le déclenchement de parties de la zone de défilement pour redessiner via l’animation se comportent comme prévu, mais perdez l’avantage du défilement accéléré pour la zone de redessination. Toute animation qui invalide la zone à défilement pendant la même image dans laquelle le défilement se produit élimine l’avantage de cette optimisation.

• Le VisualScrollableAreaClip rectangle s’aligne vers l’intérieur en pixels. Par conséquent, la taille alignée du rectangle de défilement est toujours inférieure ou égale à la taille que vous avez définie.

• Les décalages s’alignent vers le bas. Cela signifie que la différence du décalage enfichable précédent et du décalage enfichable actuel est toujours un nombre entier de pixels.

• Les tests de positionnement peuvent être désactivés jusqu’à un pixel.

• L’arrondi de disposition doit être activé, car il garantit que les bords des zones défilables et la zone cliente de fenêtre de limite sont alignées sur les limites de pixels, ce qui entraîne un alignement correct.

• L’accélération de défilement ne fonctionne pas sur les fenêtres superposées. Cela signifie que les fenêtres dans lesquelles AllowTransparency == true, window.windowstyle == none, et ainsi de suite.

• L’accélération de défilement ne se produit pas pendant le rendu de fenêtre complète.

• L’accélération de défilement ne fonctionne pas lorsque la fenêtre chevauche deux moniteurs.

• L’accélération de défilement ne fonctionne pas en présence de cibles de rendu intermédiaires dans la chaîne parente de l’élément défilement. La liste suivante présente certaines de ces cibles de rendu intermédiaires.

  • Clips

  • Effets

  • DrawingBrushes

  • VisualBrushes

  • OpacityMasks

  • Opacity

• Un seul défilement accéléré peut se produire par image. Il peut y avoir plusieurs zones de défilement accélérées, mais une seule d’entre elles peut effectuer un défilement accéléré pendant un frame. La zone à défilement est indéterminée.

• L’accélération de défilement prend en charge le contenu au-dessus de la région de défilement (dans l’ordre z) qui n’est pas défilée avec le reste du contenu. Le système calcule toutes les régions sales nécessaires et termine le défilement accéléré, mais il envoie plusieurs bitmaps supplémentaires sur le fil pour déplacer la partie déplacée involontairement à sa position correcte sur l’écran.