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 mengatur 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 ke ManipulationMode
nilai selain System
atau None
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 ManipulationMode
default khas adalah System
bukan None
. Ketika nilainya adalah System
, 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 ini System
juga memungkinkan animasi kepribadian yang merespons peristiwa manipulasi.
Slider dan ToggleSwitch memiliki templat default yang mengatur nilai ManipulationMode ke None
, jadi None
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 ManipulationMode
properti . 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 sekali 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 diatur.