UIElement.ManipulationMode Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau menetapkan nilai ManipulationModes yang digunakan untuk perilaku UIElement dan interaksi dengan gerakan. Mengatur nilai ini memungkinkan penanganan peristiwa manipulasi dari elemen ini dalam kode aplikasi.
public:
property ManipulationModes ManipulationMode { ManipulationModes get(); void set(ManipulationModes value); };
ManipulationModes ManipulationMode();
void ManipulationMode(ManipulationModes value);
public ManipulationModes ManipulationMode { get; set; }
var manipulationModes = uIElement.manipulationMode;
uIElement.manipulationMode = manipulationModes;
Public Property ManipulationMode As ManipulationModes
<uiElement ManipulationMode="All"/>
-or-
<uiElement ManipulationMode="None"/>
-or-
<uiElement ManipulationMode="singleManipulationModesMemberName"/>
-or-
<uiElement ManipulationMode="relatedManipulationModesNames"/>
Nilai Properti
Nilai atau nilai enumerasi. Defaultnya biasanya Sistem, tetapi ini dapat bervariasi pada kontrol dan elemen tertentu. Lihat Keterangan.
Keterangan
Anda harus mengatur ManipulationMode ke nilai selain Sistem atau Tidak Ada jika Anda ingin menangani peristiwa manipulasi seperti ManipulationStarted dari elemen UI dalam kode aplikasi Anda. Untuk informasi selengkapnya tentang manipulasi, lihat Menangani input penunjuk.
Nilai default umum ManipulationMode adalah Sistem daripada Tidak Ada. Ketika nilainya adalah Sistem, manipulasi yang berasal dari elemen dapat ditangani oleh infrastruktur Windows Runtime, yang didasarkan pada API Manipulasi Langsung . Misalnya, ScrollViewer menangani manipulasi pengguna dalam logika kontrolnya dan memprosesnya sebagai tindakan pengguliran untuk kontrol. Nilai Sistem juga memungkinkan animasi kepribadian yang merespons peristiwa manipulasi.
Slider dan ToggleSwitch memiliki templat default yang mengatur nilai ManipulationMode ke Tidak Ada, sehingga Tidak Ada akan menjadi nilai default yang Anda lihat pada waktu desain.
Menentukan mode manipulasi terkait
Anda dapat menentukan lebih dari salah satu nilai ManipulationModes berbendera sebagai nilai properti ManipulationMode. Ini dimungkinkan dalam XAML menggunakan sintaks koma yang ditunjukkan di bagian "Nilai XAML". Misalnya, Anda dapat menggabungkan TranslateX, TranslateY, Rotate, dan Scale, atau kombinasi apa pun dari ini. Namun, tidak semua kombinasi valid. Validitas diberlakukan hanya setelah ManipulationModes digunakan oleh kontrol tertentu, sehingga masalah dengan pengaturan kombinasi ManipulationModes yang tidak valid mungkin tidak muncul sampai run-time saat nilai diterapkan.
- Jangan gabungkan nilai Terjemahkan* dengan nilai TranslateRails*, nilai ini diperlakukan sebagai nilai yang saling eksklusif.
- Jangan gabungkan nilai inertial dengan nilai non-inertial.
- Nilai Semua bukan nilai aditif sejati dari semua bendera (jika nilai dibandingkan bitwise). Nilai Semua tidak selalu menunjukkan bahwa kombinasi semua nilai valid, atau bahwa nilai tertentu ditetapkan.
Catatan untuk versi sebelumnya
Windows 8.x On Windows 8, mengatur ManipulationMode ke nilai yang menggabungkan Sistem dengan nilai lain akan memberikan pengecualian, sehingga beberapa kombinasi yang disebutkan di atas tidak akan berfungsi untuk Windows 8. Dimulai dengan Windows 8.1, Anda dapat menggabungkan Sistem dengan nilai lain.
Aplikasi yang dikompilasi untuk Windows 8 tetapi berjalan pada Windows 8.1 menggunakan perilaku baru dan mengizinkan menggabungkan Sistem dengan nilai lain.