Visual.VisualScrollableAreaClip Eigenschaft

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Ruft einen abgeschnittenen bildlauffähigen Bereich für das Visual-Objekt ab oder legt diesen fest.

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)

Eigenschaftswert

Nullable<Rect>

Ein Rect-Objekt, das den bildlauffähigen Clippingbereich darstellt, oder null, wenn kein Clippingbereich zugewiesen ist.

Hinweise

Legen Sie die VisualScrollableAreaClip -Eigenschaft fest, um beschleunigtes Scrollen beim Rendern in Software zu aktivieren. Dies ist in Remoterenderingszenarien nützlich, z. B. bei der Ausführung über Remotedesktop oder beim Ausführen auf einem virtuellen Computer. Legen Sie diese Eigenschaft für das übergeordnete Element fest, dessen untergeordnete Elemente gescrollt werden. Das Festlegen der VisualScrollableAreaClip Eigenschaft hat keine Auswirkungen, wenn das Rendern hardwarebeschleunigt ist.

Die VisualScrollableAreaClip -Eigenschaft ermöglicht bestimmte, erweiterte Szenarien. In der folgenden Liste sind die Einschränkungen aufgeführt, die bei Verwendung der VisualScrollableAreaClip -Eigenschaft gelten.

• Der Hintergrund des scrollenden Bereichs muss undurchsichtig sein, sonst treten Scrollartefakte auf.

• Die VisualScrollableAreaClip Eigenschaft beschleunigt den Bildlauf nur, wenn WPF in Software gerendert wird. Diese Situation tritt beispielsweise auf, wenn die Anwendung über Remotedesktop ausgeführt wird oder lokal auf einem virtuellen Computer ausgeführt wird.

• Das Scrollverhalten bleibt beim Rendern in der Hardware unverändert. Um Unterschiede beim Bildlaufverhalten zu vermeiden, sollten Sie die VisualScrollableAreaClip Eigenschaft sowohl für Hardware als auch für Software aktiviert lassen.

• Drehen und Verschieben von Transformationen deaktivieren beschleunigtes Scrollen. Skalierungstransformationen und horizontale oder vertikale Übersetzungen über dem Scrollbereich funktionieren ordnungsgemäß und deaktivieren die Bildlaufbeschleunigung nicht.

• Das Ändern der Unterstruktur oder das Auslösen von Teilen des bildlaufbaren Bereichs über eine Animation verhalten sich wie erwartet, verlieren jedoch den Vorteil des beschleunigten Scrollens für den neu gezeichneten Bereich. Jede Animation, die den Scrollbereich während desselben Bildlaufs ungültig macht, beseitigt den Vorteil dieser Optimierung.

• Das VisualScrollableAreaClip Rechteck wird nach innen an Pixeln angerast. Daher ist die angeknockte Größe des Bildlaufrechtecks immer kleiner oder gleich der von Ihnen festgelegten Größe.

• Offsets werden nach unten angerast. Dies bedeutet, dass der Unterschied zwischen dem vorherigen angeknockten Offset und dem aktuellen angeknockten Offset immer eine ganze Pixelzahl ist.

• Treffertests können bis zu einem Pixel deaktiviert sein.

• Die Layoutrundung sollte aktiviert sein, da dadurch sichergestellt wird, dass die Kanten von scrollbaren Bereichen und der Clientbereich des Begrenzungsfensters an Pixelgrenzen angedockt werden, was zu einer korrekten Ausrichtung führt.

• Die Beschleunigung des Bildlaufs funktioniert nicht in mehrstufigen Fenstern. Dies bedeutet Fenster, in denen AllowTransparency == true, window.windowstyle == none usw.

• Die Bildlaufbeschleunigung tritt während des Vollständigen Fensterrenderings nicht auf.

• Die Bildlaufbeschleunigung funktioniert nicht, wenn das Fenster zwei Monitore umfasst.

• Die Scrollbeschleunigung funktioniert nicht, wenn zwischengeschaltete Renderziele in der übergeordneten Kette des scrollenden Elements vorhanden sind. Die folgende Liste zeigt einige dieser zwischengeschalteten Renderziele.

  • Clips

  • Effekte

  • DrawingBrushes

  • VisualBrushes

  • OpacityMasks

  • Opacity

• Pro Frame kann nur ein beschleunigter Bildlauf erfolgen. Es kann mehrere beschleunigte Bildlaufbereiche geben, aber nur einer von ihnen kann einen beschleunigten Bildlauf während eines Frames ausführen. Welcher Bereich gescrollt wird, ist unbestimmt.

• Die Bildlaufbeschleunigung unterstützt Inhalte über dem Bildlaufbereich (in z-Reihenfolge), die nicht mit dem restlichen Inhalt gescrollt werden. Das System berechnet alle erforderlichen schmutzigen Regionen und schließt den beschleunigten Bildlauf ab, sendet jedoch mehrere zusätzliche Bitmaps über den Draht, um den unbeabsichtigt gescrollten Teil zurück an seine richtige Position auf dem Bildschirm zu verschieben.