Visual.VisualScrollableAreaClip Eigenschaft

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 VisualScrollableAreaClip die-Eigenschaft fest, um beim Rendering in Software einen beschleunigten Bildlauf zu ermöglichenSet the VisualScrollableAreaClip property to enable accelerated scrolling when rendering in software. Dies ist in remoterenderingszenarien hilfreich, z. b. bei der Ausführung über Remotedesktop oder der Ausführung auf einem virtuellen Computer.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 fest, dessen untergeordnete Elemente gescrollt werden.Set this property on the parent element whose children will be scrolled. Das Festlegen VisualScrollableAreaClip der-Eigenschaft hat keine Auswirkungen, wenn das Rendering Hardware beschleunigt ist.Setting the VisualScrollableAreaClip property has no effect when rendering is hardware accelerated.

Die VisualScrollableAreaClip -Eigenschaft ermöglicht bestimmte, Erweiterte Szenarien.The VisualScrollableAreaClip property enables specific, advanced scenarios. Die folgende Liste enthält die Einschränkungen, die bei der Verwendung der VisualScrollableAreaClip -Eigenschaft zutreffen.The following list shows the caveats that apply when you use the VisualScrollableAreaClip property.

  • Der Hintergrund des gescrollten Bereichs muss undurchsichtig sein, oder es werden scrollartefakte ausgeführt.The background of the scrolled area must be opaque, or scrolling artifacts will occur.

  • Die VisualScrollableAreaClip -Eigenschaft beschleunigt den Bildlauf nur, wenn WPF in Software gerendert wird.The VisualScrollableAreaClip property accelerates scrolling only when WPF is rendering in software. Diese Situation tritt beispielsweise auf, wenn die Anwendung über 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.

  • Das Scrollverhalten ist beim Rendern in der Hardware unverändert.The scrolling behavior is unchanged when rendering in hardware. Um Unterschiede beim Scrollverhalten zu vermeiden, sollten Sie VisualScrollableAreaClip die-Eigenschaft für Hardware und Software aktiviert halten.To prevent differences in scrolling behavior, you should keep the VisualScrollableAreaClip property enabled for both hardware and software.

  • Durch Drehen und neigen von Transformationen wird beschleunigter Bildlauf deaktiviert.Rotate and skew transforms disable accelerated scrolling. Skalierungs Transformationen und horizontale oder vertikale Übersetzungen oberhalb der hochskalierten Region funktionieren ordnungsgemäß und deaktivieren die Bild Lauf Beschleunigung nicht.Scale transforms and horizontal or vertical translations above the scrolled region work correctly and do not disable scrolling acceleration.

  • Das Ändern der Teilstruktur oder das Auslösen von Teilen des Bild lauffähigen Bereichs, der über die Animation neu gezeichnet werden soll, verhält sich erwartungsgemäß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. Jede Animation, die den Schiebe Bereich im gleichen Frame, in dem der Bildlauf ausgeführt wird, macht den Vorteil dieser Optimierung nicht mehr.Any animation that invalidates the scrolled area during the same frame in which scrolling occurs eliminates the benefit of this optimization.

  • Das VisualScrollableAreaClip Rechteck wird in Pixel angezeigt.The VisualScrollableAreaClip rectangle snaps inward to pixels. Daher ist die Größe des scrollrechtecks immer kleiner 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 der Unterschied zwischen dem vorherigen ausgeschnittenen Offset und dem aktuellen ausgelassenen Offset immer eine ganzzahlige Anzahl von Pixeln ist.This means that the difference of the previous snapped offset and current snapped offset is always an integer number of pixels.

  • Treffer Tests können bis zu einem Pixel deaktiviert werden.Hit tests can be off by up to a pixel.

  • Die Layoutrundung sollte aktiviert sein, da dadurch sichergestellt wird, dass die Ränder der Bild lauffähigen Bereiche und des Client Bereichs des Begrenzungs Fensters an Pixel Begrenzungen angedockt werdenLayout 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.

  • Die Bild Lauf Beschleunigung funktioniert nicht bei mehrschichtigen Fenstern.Scrolling acceleration does not work on layered windows. Dies bedeutet, dass Windows, in dem AllowTransparency = = true, Window. WindowStyle = = None usw. angezeigt wird.This means windows in which AllowTransparency == true, window.windowstyle == none, and so on.

  • Die Beschleunigung des Bildlaufs tritt nicht während des vollständigen Fenster Rendering auf.Scrolling acceleration does not occur during full-window rendering.

  • Die Bild Lauf Beschleunigung funktioniert nicht, wenn das Fenster zwei Monitore überschreitet.Scrolling acceleration does not work when the window straddles two monitors.

  • Die Bild Lauf Beschleunigung funktioniert nicht, wenn zwischen-Renderingziele in der übergeordneten Kette des aufgeschlüsselten Elements vorhanden sind.Scrolling acceleration does not work in the presence of intermediate render targets in the parent chain of the scrolled element. In der folgenden Liste sind einige dieser zwischenrenderingziele aufgeführt.The following list shows some of these intermediate render targets.

    • TanzClips

    • EffekteEffects

    • DrawingBrushDrawingBrushes

    • VisualBrushVisualBrushes

    • OpacityMasksOpacityMasks

    • DeckkraftOpacity

  • Pro Frame kann nur ein beschleunigter scrollvorgang ausgeführt werden.Only one accelerated scroll can happen per frame. Es können mehrere beschleunigte Bild Lauf Bereiche vorhanden sein, aber nur eine von Ihnen kann während eines Frames einen beschleunigten Bildlauf ausführen.There can be multiple accelerated scroll areas, but only one of them can perform an accelerated scroll during a frame. Der Bereich, für den ein Rollup ausgeführt wird, ist unbestimmtWhich area is scrolled is indeterminate.

  • Die Bild Lauf Beschleunigung unterstützt Inhalte oberhalb des scrollbereichs (in der z-Reihenfolge), der nicht mit dem restlichen Inhalt durchsucht wird.Scrolling acceleration supports content above the scrolling region (in z-order) that is not scrolled with the rest of the content. Das System berechnet alle erforderlichen Änderungs Bereiche und schließt den beschleunigten Bild Lauf aus, sendet jedoch mehrere zusätzliche Bitmaps über das Netzwerk, um den versehentlich aufgeschalten Teil wieder an die richtige Position auf dem Bildschirm zu verschieben.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: