UIElement.ManipulationMode Properti

Definisi

Ruang nama:

Windows.UI.Xaml

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

ManipulationModes

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.

Lihat juga

• ManipulationStarted
• ManipulationDelta
• ManipulationCompleted
• ManipulationModes
• Menangani input penunjuk
• Referensi Manipulasi Langsung
• Sampel input dasar (Windows 10)