Visual.VisualScrollableAreaClip Właściwość

Definicja

Pobiera lub ustawia obszar przewijania przycinania dla 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 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)

Wartość właściwości

Rect, który reprezentuje przewijany obszar przycinania lub null, jeśli nie przypisano obszaru przycinania.A Rect that represents the scrollable clipping area, or null if no clipping area is assigned.

Uwagi

Ustaw właściwość VisualScrollableAreaClip, aby włączyć przyspieszenie przewijania podczas renderowania w oprogramowaniu.Set the VisualScrollableAreaClip property to enable accelerated scrolling when rendering in software. Jest to przydatne w scenariuszach renderowania zdalnego, takich jak uruchamianie przez Pulpit zdalny lub uruchamianie na maszynie wirtualnej.This is useful in remote rendering scenarios, such as running over Remote Desktop or running in a virtual machine. Ustaw tę właściwość dla elementu nadrzędnego, którego elementy podrzędne zostaną przeprzewijane.Set this property on the parent element whose children will be scrolled. Ustawienie właściwości VisualScrollableAreaClip nie ma znaczenia, gdy renderowanie jest przyspieszone.Setting the VisualScrollableAreaClip property has no effect when rendering is hardware accelerated.

Właściwość VisualScrollableAreaClip umożliwia wykonywanie konkretnych, zaawansowanych scenariuszy.The VisualScrollableAreaClip property enables specific, advanced scenarios. Na poniższej liście przedstawiono zastrzeżenia, które mają zastosowanie w przypadku użycia właściwości VisualScrollableAreaClip.The following list shows the caveats that apply when you use the VisualScrollableAreaClip property.

  • Tło przewijanego obszaru musi być nieprzezroczyste lub następuje przewinięcie artefaktów.The background of the scrolled area must be opaque, or scrolling artifacts will occur.

  • Właściwość VisualScrollableAreaClip przyspiesza przewijanie tylko wtedy, gdy WPF jest renderowana w oprogramowaniu.The VisualScrollableAreaClip property accelerates scrolling only when WPF is rendering in software. Na przykład taka sytuacja występuje, gdy aplikacja działa przez Pulpit zdalny lub działa lokalnie na maszynie wirtualnej.For example, this situation occurs when the application is running over Remote Desktop or running locally in a virtual machine.

  • Zachowanie przewijania jest niezmienione podczas renderowania sprzętowego.The scrolling behavior is unchanged when rendering in hardware. Aby zapobiec różnicom w zachowaniu przewijania, należy zachować Właściwość VisualScrollableAreaClip włączoną dla sprzętu i oprogramowania.To prevent differences in scrolling behavior, you should keep the VisualScrollableAreaClip property enabled for both hardware and software.

  • Przekształcenia Obróć i pochyl powodują wyłączenie przyspieszania przewijania.Rotate and skew transforms disable accelerated scrolling. Przekształceń skalowania i w poziomie lub w pionie powyżej przewinięcie regionu działają prawidłowo i nie należy wyłączać przyspieszenia przewijania.Scale transforms and horizontal or vertical translations above the scrolled region work correctly and do not disable scrolling acceleration.

  • Zmiana poddrzewa lub wyzwolenie części obszaru przewijanego do ponownego rysowania przy użyciu animacji zachowuje się zgodnie z oczekiwaniami, ale utracisz korzyść przyspieszenia przewijania dla ponownie narysowanego obszaru.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. Każda animacja, która unieważnia przewijany obszar w tej samej klatce, w której występuje przewijanie eliminuje korzyść tej optymalizacji.Any animation that invalidates the scrolled area during the same frame in which scrolling occurs eliminates the benefit of this optimization.

  • Prostokąt VisualScrollableAreaClip przyciąga do wewnątrz do pikseli.The VisualScrollableAreaClip rectangle snaps inward to pixels. W związku z tym rozmiar przypiętego prostokąta przewijania jest zawsze mniejszy lub równy rozmiarowi ustawionemu przez użytkownika.Therefore, the snapped size of the scrolling rectangle is always less than or equal to the size you have set.

  • Przesunięcia w dół.Offsets snap downward. Oznacza to, że różnica poprzedniego przyciągania i bieżącego przyciągania jest zawsze liczbą całkowitą pikseli.This means that the difference of the previous snapped offset and current snapped offset is always an integer number of pixels.

  • Testy trafień można wyłączyć nawet o jeden piksel.Hit tests can be off by up to a pixel.

  • Zaokrąglanie układu powinno być włączone, ponieważ zapewnia, że krawędzie obszarów przewijanych i obszaru klienta okna granicy są przyciągane do krawędzi pikseli, co skutkuje prawidłowym wyrównaniem.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.

  • Przyspieszenie przewijania nie działa w przypadku okien z warstwami.Scrolling acceleration does not work on layered windows. Oznacza to, że system Windows, w którym AllowTransparency = = true, Window. WindowName = = None i tak dalej.This means windows in which AllowTransparency == true, window.windowstyle == none, and so on.

  • Przyspieszenie przewijania nie występuje podczas renderowania pełnego okna.Scrolling acceleration does not occur during full-window rendering.

  • Przyspieszenie przewijania nie działa, gdy okno zawiera dwa monitory.Scrolling acceleration does not work when the window straddles two monitors.

  • Przyspieszenie przewijania nie działa w obecności pośrednich obiektów docelowych renderowania w łańcuchu nadrzędnym przewijanego elementu.Scrolling acceleration does not work in the presence of intermediate render targets in the parent chain of the scrolled element. Poniższa lista zawiera niektóre z tych pośrednich elementów docelowych renderowania.The following list shows some of these intermediate render targets.

    • FilmClips

    • EfektyEffects

    • DrawingBrushesDrawingBrushes

    • VisualBrushesVisualBrushes

    • OpacityMasksOpacityMasks

    • NieprzezroczystośćOpacity

  • Tylko jedno przyspieszone przewijanie może wystąpić na klatkę.Only one accelerated scroll can happen per frame. Może istnieć wiele szybszych obszarów przewijania, ale tylko jedna z nich może wykonywać przyspieszenie przewijania w ramce.There can be multiple accelerated scroll areas, but only one of them can perform an accelerated scroll during a frame. Obszar, który jest przewijany jest nieokreślony.Which area is scrolled is indeterminate.

  • Przyspieszenie przewijania obsługuje zawartość powyżej regionu przewijania (w kolejności z), która nie jest przewijana wraz z resztą zawartości.Scrolling acceleration supports content above the scrolling region (in z-order) that is not scrolled with the rest of the content. System oblicza wszystkie niepotrzebne regiony zanieczyszczone i wykonuje przyspieszone przewijanie, ale wysyła kilka dodatkowych map bitowych za pośrednictwem sieci, aby przenieść przypadkowo przewinięcie części do odpowiedniej pozycji na ekranie.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.

Dotyczy