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

Definition

Ruft einen abgeschnittenen bildlauffähigen Bereich für das Visual-Objekt ab oder legt diesen fest.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)

Eigenschaftswert

Ein Rect-Objekt, das den bildlauffähigen Clippingbereich darstellt, oder null, wenn kein Clippingbereich zugewiesen ist.A Rect that represents the scrollable clipping area, or null if no clipping area is assigned.

Hinweise

Legen Sie die VisualScrollableAreaClip Eigenschaft zum Aktivieren von accelerated Durchführen eines Bildlaufs beim Rendern in Software.Set the VisualScrollableAreaClip property to enable accelerated scrolling when rendering in software. Dies ist nützlich in Szenarien mit remote-Rendering, z. B. per Remotedesktop ausgeführt wird, oder auf einem virtuellen Computer ausgeführt wird.This is useful in remote rendering scenarios, such as running over Remote Desktop or running in a virtual machine. Legen Sie diese Eigenschaft für das übergeordnete Element, dessen untergeordnete Elemente ein Bildlauf durchgeführt werden.Set this property on the parent element whose children will be scrolled. Festlegen der VisualScrollableAreaClip Eigenschaft hat keine Auswirkungen, wenn das Rendering hardwarebeschleunigt ist.Setting the VisualScrollableAreaClip property has no effect when rendering is hardware accelerated.

Die VisualScrollableAreaClip -Eigenschaft ermöglicht es, bestimmte erweiterte Szenarien.The VisualScrollableAreaClip property enables specific, advanced scenarios. Die folgende Liste enthält die Einschränkungen, die gelten, wenn Sie die VisualScrollableAreaClip Eigenschaft.The following list shows the caveats that apply when you use the VisualScrollableAreaClip property.

  • Der Hintergrund des Bereichs ein Bildlauf ausgeführt wird, muss nicht transparent sein, oder Durchführen eines Bildlaufs Artefakte erfolgt.The background of the scrolled area must be opaque, or scrolling artifacts will occur.

  • Die VisualScrollableAreaClip -Eigenschaft beschleunigt Bildläufe nur, wenn WPF in der Software rendert.The VisualScrollableAreaClip property accelerates scrolling only when WPF is rendering in software. Dies geschieht beispielsweise, wenn die Anwendung per Remotedesktop ausgeführt wird oder lokal auf einem virtuellen Computer ausgeführt wird.For example, this situation occurs when the application is running over Remote Desktop or running locally in a virtual machine.

  • Beim Rendern von Hardware, ist das Bildlaufverhalten unverändert.The scrolling behavior is unchanged when rendering in hardware. Um die Unterschiede im Verhalten zu verhindern, sollten Sie halten die VisualScrollableAreaClip Eigenschaft, die für Hardware und Software aktiviert.To prevent differences in scrolling behavior, you should keep the VisualScrollableAreaClip property enabled for both hardware and software.

  • Deaktivieren der drehen und neigen Transformationen beschleunigten Bildlauf.Rotate and skew transforms disable accelerated scrolling. Skalierungstransformationen horizontale oder vertikale Übersetzungen über dem Bereich der Bildlauf ausgeführt wurde ordnungsgemäß funktionieren und Bildlauf Beschleunigung nicht zu deaktivieren.Scale transforms and horizontal or vertical translations above the scrolled region work correctly and do not disable scrolling acceleration.

  • Ändern der Teilstruktur oder Auslösen von Teilen des bildlauffähigen Bereichs über Animation neu zeichnen Verhalten sich wie erwartet, aber die Vorteile der beschleunigten Bildlauf für den Bereich neu gezeichnet.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. Alle Animationen, die den Bereich der Bildlauf ausgeführt wurde während des Frames erklärt in dem ein Bildlauf auftritt, den Vorteil, dass diese Optimierung beseitigt.Any animation that invalidates the scrolled area during the same frame in which scrolling occurs eliminates the benefit of this optimization.

  • Die VisualScrollableAreaClip Rechtecks richtet sich nach innen an Pixeln.The VisualScrollableAreaClip rectangle snaps inward to pixels. Aus diesem Grund ist die angedockte Größe des Rechtecks Bildlauf immer kleiner als oder gleich der Größe, die Sie festgelegt haben.Therefore, the snapped size of the scrolling rectangle is always less than or equal to the size you have set.

  • Offsets werden nach unten ausgerichtet.Offsets snap downward. Dies bedeutet, dass die Differenz zwischen dem vorherigen Offset ausgerichteten und der aktuelle Offset der angedockten immer eine ganze Zahl von Pixeln ist.This means that the difference of the previous snapped offset and current snapped offset is always an integer number of pixels.

  • Auf Treffer überprüft können von bis zu ein Pixel aufweisen.Hit tests can be off by up to a pixel.

  • Layoutglättung sollte, aktiviert werden, da er sicherstellt, dass es sich bei die Rändern des bildlauffähigen Bereiche und der Clientbereich der Grenze-Fensters auf Pixelgrenzen, was in der richtigen Ausrichtung ausgerichtet sind.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.

  • Durchführen eines Bildlaufs Acceleration funktioniert nicht für überlappende Fenster.Scrolling acceleration does not work on layered windows. Dies bedeutet, dass Windows, in denen AllowTransparency == "true" window.windowstyle == keine und so weiter.This means windows in which AllowTransparency == true, window.windowstyle == none, and so on.

  • Durchführen eines Bildlaufs Beschleunigung erfolgt während des Renderns von Fensterinhalt nicht.Scrolling acceleration does not occur during full-window rendering.

  • Durchführen eines Bildlaufs Beschleunigung ist nicht möglich, wenn das Fenster über zwei Monitore überspannt.Scrolling acceleration does not work when the window straddles two monitors.

  • Durchführen eines Bildlaufs Acceleration funktioniert nicht bei Zwischenrenderingzielen in der übergeordneten Kette des Elements ein Bildlauf ausgeführt wird.Scrolling acceleration does not work in the presence of intermediate render targets in the parent chain of the scrolled element. Die folgende Liste zeigt, dass einige dieser Zwischenrenderingziele.The following list shows some of these intermediate render targets.

    • ClipsClips

    • EffekteEffects

    • DrawingBrushesDrawingBrushes

    • VisualBrushesVisualBrushes

    • OpacityMasksOpacityMasks

    • DeckkraftOpacity

  • Nur eine beschleunigte Scrollen möglich pro Frame.Only one accelerated scroll can happen per frame. Mehrere Bereiche der beschleunigten Bildlauf möglich, aber nur eine von ihnen kann einen beschleunigten Bildlauf ausführen, während eines Frames.There can be multiple accelerated scroll areas, but only one of them can perform an accelerated scroll during a frame. Der Bereich ein Bildlauf durchgeführt wird, ist unbestimmt.Which area is scrolled is indeterminate.

  • Durchführen eines Bildlaufs Acceleration bietet Unterstützung für Inhalte über Bildlaufbereich (in der Z-Reihenfolge), der nicht mit den restlichen Inhalt ein Bildlauf durchgeführt wird.Scrolling acceleration supports content above the scrolling region (in z-order) that is not scrolled with the rest of the content. Das System alle notwendigen geänderten Bereiche berechnet und schließt den beschleunigten Bildlauf, aber es sendet mehrere zusätzliche Bitmaps über das Netzwerk zum Verschieben des unbeabsichtigt Bildlauf Teils zur richtigen Position auf dem Bildschirm zurück.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.

Gilt für: