Visual.VisualScrollableAreaClip Properti

Definisi

Ruang nama:

System.Windows.Media

Rakitan:

PresentationCore.dll

Mendapatkan atau mengatur area yang dapat digulir terklip untuk 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)

Nilai Properti

Nullable<Rect>

Rect yang mewakili area kliping yang dapat digulir, atau null jika tidak ada area kliping yang ditetapkan.

Keterangan

Atur VisualScrollableAreaClip properti untuk mengaktifkan pengguliran terakselerasi saat penyajian dalam perangkat lunak. Ini berguna dalam skenario penyajian jarak jauh, seperti berjalan melalui Desktop Jauh atau berjalan di komputer virtual. Atur properti ini pada elemen induk yang turunannya akan digulir. VisualScrollableAreaClip Pengaturan properti tidak berpengaruh ketika penyajian dipercepat perangkat keras.

Properti VisualScrollableAreaClip memungkinkan skenario tingkat lanjut tertentu. Daftar berikut ini memperlihatkan peringatan yang berlaku saat Anda menggunakan VisualScrollableAreaClip properti .

• Latar belakang area yang digulir harus buram, atau artefak gulir akan terjadi.

• Properti VisualScrollableAreaClip mempercepat pengguliran hanya ketika WPF merender dalam perangkat lunak. Misalnya, situasi ini terjadi ketika aplikasi berjalan melalui Desktop Jauh atau berjalan secara lokal di komputer virtual.

• Perilaku pengguliran tidak berubah saat merender di perangkat keras. Untuk mencegah perbedaan perilaku gulir, Anda harus mengaktifkan VisualScrollableAreaClip properti untuk perangkat keras dan perangkat lunak.

• Transformasi putar dan condong menonaktifkan pengguliran yang dipercepat. Transformasi skala dan terjemahan horizontal atau vertikal di atas wilayah yang digulir berfungsi dengan benar dan tidak menonaktifkan akselerasi pengguliran.

• Mengubah subtree atau memicu bagian area yang dapat digulir untuk digambar ulang melalui animasi berperilaku seperti yang diharapkan, tetapi kehilangan manfaat gulir yang dipercepat untuk area redrawn. Animasi apa pun yang membatalkan area yang digulir selama bingkai yang sama di mana pengguliran terjadi menghilangkan manfaat pengoptimalan ini.

• Persegi VisualScrollableAreaClip panjang diposisikan ke dalam piksel. Oleh karena itu, ukuran persegi panjang yang di-snap selalu kurang dari atau sama dengan ukuran yang telah Anda tetapkan.

• Offset snap ke bawah. Ini berarti bahwa perbedaan offset yang diciutkan sebelumnya dan offset yang diciutkan saat ini selalu merupakan jumlah bilangan bulat piksel.

• Tes hit dapat dilakukan hingga satu piksel.

• Pembulatan tata letak harus diaktifkan, karena memastikan bahwa tepi area yang dapat digulir dan area klien jendela batas ditekan ke batas piksel, sehingga menghasilkan perataan yang benar.

• Akselerasi gulir tidak berfungsi pada jendela berlapis. Ini berarti jendela tempat AllowTransparency == true, window.windowstyle == none, dan sebagainya.

• Akselerasi pengguliran tidak terjadi selama penyajian jendela penuh.

• Akselerasi pengguliran tidak berfungsi ketika jendela meluaskan dua monitor.

• Akselerasi gulir tidak berfungsi di hadapan target render perantara dalam rantai induk elemen yang digulirkan. Daftar berikut menunjukkan beberapa target render perantara ini.

  • Klip

  • Efek

  • GambarBrush

  • VisualBrush

  • OpacityMasks

  • Keburaman

• Hanya satu gulir yang dipercepat yang dapat terjadi per bingkai. Mungkin ada beberapa area gulir yang dipercepat, tetapi hanya salah satunya yang dapat melakukan gulir yang dipercepat selama bingkai. Area mana yang digulir tidak ditentukan.

• Akselerasi gulir mendukung konten di atas wilayah gulir (dalam urutan z) yang tidak digulir dengan konten lainnya. Sistem menghitung semua wilayah kotor yang diperlukan dan menyelesaikan gulir yang dipercepat, tetapi mengirimkan beberapa bitmap tambahan melalui kawat untuk memindahkan bagian yang tidak sengaja digulir kembali ke posisi yang benar di layar.