UIElement.ManipulationMode Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml

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

ManipulationModes

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, , TranslateYRotate, 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.

Lihat juga

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