Visual.VisualScrollableAreaClip Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Pobiera lub ustawia przycięty obszar przewijania dla obiektu 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

Nullable<Rect>

Element Rect reprezentujący przewijany obszar wycinki lub null jeśli nie przypisano żadnego obszaru wycinków.

Uwagi

VisualScrollableAreaClip Ustaw właściwość, aby włączyć przyspieszone przewijanie podczas renderowania w oprogramowaniu. Jest to przydatne w scenariuszach zdalnego renderowania, takich jak uruchamianie pulpitu zdalnego lub uruchamianie na maszynie wirtualnej. Ustaw tę właściwość na elemecie nadrzędnym, którego elementy podrzędne zostaną przewijane. VisualScrollableAreaClip Ustawienie właściwości nie ma wpływu, gdy renderowanie jest przyspieszane sprzętowo.

Właściwość VisualScrollableAreaClip umożliwia konkretne, zaawansowane scenariusze. Na poniższej liście przedstawiono zastrzeżenia, które mają zastosowanie podczas korzystania z VisualScrollableAreaClip właściwości .

• Tło przewijanego obszaru musi być nieprzezroczyste lub zostaną wykonane przewijające artefakty.

• Właściwość VisualScrollableAreaClip przyspiesza przewijanie tylko wtedy, gdy WPF renderuje się w oprogramowaniu. Na przykład taka sytuacja występuje, gdy aplikacja jest uruchomiona za pośrednictwem pulpitu zdalnego lub działa lokalnie na maszynie wirtualnej.

• Zachowanie przewijania jest niezmienione podczas renderowania w sprzęcie. Aby zapobiec różnicom w zachowaniu przewijania, należy zachować włączoną VisualScrollableAreaClip właściwość zarówno dla sprzętu, jak i oprogramowania.

• Obracanie i niesymetryczne przekształcenia wyłącza przyspieszone przewijanie. Skalowanie przekształceń i translacji poziomych lub pionowych nad przewiniętym regionem działa prawidłowo i nie wyłączaj przyspieszania przewijania.

• Zmiana poddrzewa lub wyzwalanie części obszaru z możliwością przewijania w celu ponownego narysowania za pomocą animacji działa zgodnie z oczekiwaniami, ale traci korzyści z przyspieszonego przewijania obszaru ponownego rysowania. Każda animacja, która unieważnia przewijany obszar podczas tej samej ramki, w której przewijanie występuje, eliminuje korzyści wynikające z tej optymalizacji.

• Prostokąt VisualScrollableAreaClip jest przyciągany do wewnątrz do pikseli. W związku z tym rozmiar przyciągania prostokąta przewijania jest zawsze mniejszy niż lub równy ustawionemu rozmiarowi.

• Przesunięcia przyciągania w dół. Oznacza to, że różnica poprzedniego przyciętego przesunięcia i bieżącego przesunięcia przyciętego jest zawsze liczbą całkowitą pikseli.

• Testy trafień mogą być wyłączone przez maksymalnie piksel.

• Zaokrąglanie układu powinno być włączone, ponieważ zapewnia, że krawędzie obszarów przewijanych i obszar klienta okna granic są przyciągane do granic pikseli, co powoduje poprawne wyrównanie.

• Przyspieszanie przewijania nie działa w oknach warstwowych. Oznacza to okna, w których AllowTransparency == true, window.windowstyle == none itd.

• Przyspieszanie przewijania nie występuje podczas renderowania pełnego okna.

• Przyspieszanie przewijania nie działa, gdy okno łączy dwa monitory.

• Przyspieszanie przewijania nie działa w obecności pośrednich obiektów docelowych renderowania w łańcuchu nadrzędnym przewijanego elementu. Na poniższej liście przedstawiono niektóre z tych pośrednich elementów docelowych renderowania.

  • Klipy

  • Efekty

  • RysowanieBrushes

  • VisualBrushes

  • Maski nieprzezroczystości

  • Krycie

• Na ramkę może wystąpić tylko jeden przyspieszony przewijanie. Może istnieć wiele przyspieszonych obszarów przewijania, ale tylko jeden z nich może wykonywać przyspieszone przewijanie podczas ramki. Który obszar jest przewijany, jest nieokreślony.

• Przyspieszanie przewijania obsługuje zawartość nad regionem przewijania (w kolejności z), który nie jest przewijany z resztą zawartości. System oblicza wszystkie niezbędne zanieczyszczone regiony i kończy przyspieszony przewijanie, ale wysyła kilka dodatkowych map bitowych przez drut, aby przenieść przypadkowo przewijaną część z powrotem do prawidłowej pozycji na ekranie.