UIElement.Tapped Kejadian

Definisi

Terjadi ketika interaksi Ketuk yang tidak tertangani terjadi di atas area pengujian hit elemen ini.

public:
 virtual event TappedEventHandler ^ Tapped;
// Register
event_token Tapped(TappedEventHandler const& handler) const;

// Revoke with event_token
void Tapped(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::Tapped_revoker Tapped(auto_revoke_t, TappedEventHandler const& handler) const;
public event TappedEventHandler Tapped;
function onTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("tapped", onTapped);
uIElement.removeEventListener("tapped", onTapped);
- or -
uIElement.ontapped = onTapped;
Public Custom Event Tapped As TappedEventHandler 
<uiElement Tapped="eventhandler"/>

Jenis Acara

Keterangan

Perangkat sentuh, mouse, dan perangkat pena semuanya dapat menghasilkan tindakan Ketuk . Untuk informasi selengkapnya, lihat Menangani input penunjuk.

Lihat Desain interaksi sentuh untuk informasi selengkapnya tentang cara menggunakan interaksi Ketuk di desain aplikasi Anda. Ide umumnya adalah bahwa interaksi Ketuk pada elemen memanggil tindakan utama elemen di aplikasi Anda.

Peristiwa yang diketuk mewakili gerakan, sedangkan peristiwa PointerPressed adalah peristiwa input tingkat yang lebih rendah. Peristiwa yang diketuk dan PointerPressed dapat dinaikkan sebagai hasil dari interaksi pengguna tunggal. Jika sumber peristiwa memiliki ManipulationMode nondefault, ManipulationStarting juga dapat dinaikkan. Bahkan jika kontrol sudah menangani PointerPressed dalam logika kontrol, atau menangani manipulasi, itu tidak mencegah Tapped dinaikkan.

Peristiwa yang diketuk berpotensi menghasilkan lebih dari satu titik pointer. Untuk peristiwa gerakan tingkat lebih tinggi seperti Disadap, Anda tidak lagi memiliki akses langsung ke detail PointerPoint seperti nilai PointerId individual atau koordinat individual. Anda memiliki akses ke jenis perangkat (PointerDeviceType) dan untuk koordinat Anda dapat memanggil GetPosition, yang memberikan rata-rata koordinat untuk Ketuk dari lebih dari satu titik pointer.

Disadap adalah peristiwa yang dirutekan. Selain itu, elemen harus memiliki IsTapEnabledbenar untuk menjadi sumber peristiwa yang Diketuk (benar adalah defaultnya). Dimungkinkan untuk menangani Diketuk pada elemen induk bahkan jika IsTapEnabledsalah pada elemen induk, jika peristiwa gelembung ke induk dari elemen turunan sumber peristiwa di mana IsTapEnabledsalah. Untuk informasi selengkapnya tentang konsep peristiwa yang dirutekan, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.

Untuk tindakan sentuhan dan juga untuk peristiwa khusus interaksi atau manipulasi yang merupakan konsekuensi dari tindakan sentuhan, elemen harus di-hit-test agar dapat menjadi sumber peristiwa. UIElement.Visibility harus Terlihat. Properti lain dari jenis turunan juga memengaruhi visibilitas hit-test. Untuk informasi selengkapnya, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.

Ketuk mendukung kemampuan untuk melampirkan penanganan aktivitas ke rute yang akan dipanggil meskipun data peristiwa untuk peristiwa ditandai Ditangani. Lihat AddHandler.

Kontrol Windows Runtime tertentu mungkin juga memiliki penanganan berbasis kelas untuk peristiwa yang disadap. Jika demikian, kontrol mungkin memiliki penimpaan untuk metode OnTapped. Untuk informasi selengkapnya tentang cara kerja penanganan berbasis kelas untuk peristiwa, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.

Disadap dan Ditahan saling eksklusif. Sistem input harus menunggu sampai titik penunjuk dilepaskan untuk menentukan apakah tindakan harus Diketuk, Ditahan , atau beberapa gerakan lainnya, sehingga Anda tidak disadap pada saat pengguna menyentuh layar. Jika Anda benar-benar membutuhkan umpan balik instan, Anda mungkin ingin menggunakan PointerPressed sebagai gantinya.

Jika interaksi pengguna juga menaikkan DoubleTapped, Tapped akan dinaikkan terlebih dahulu untuk mewakili ketukan pertama, tetapi ketukan kedua tidak akan menaikkan Ketukan tambahan. Jika Anda ingin logika yang berbeda untuk Disadap versus DoubleTapped, handler Tapped Anda mungkin perlu menggunakan variabel khusus aplikasi dan timer untuk menghindari berjalan pada interaksi yang akhirnya ditafsirkan sebagai tindakan DoubleTap .

Disadap untuk input mouse dan pena/stylus

Sistem input memproses tindakan di mana pengguna mengklik tombol mouse kiri sementara di atas elemen sebagai tindakan Diketuk. Peristiwa tidak diaktifkan sampai tombol mouse kiri dilepaskan. Input mouse tidak menghasilkan peristiwa Holding secara default, tidak peduli berapa lama tombol mouse ditahan, atau tombol mana yang ditahan.

Untuk perangkat pena, menyentuh perangkat pena ke permukaan dan tetap berada di satu tempat menghasilkan tindakan Tahan .

Kontrol yang tidak menaikkan peristiwa yang Disadap

Kontrol ini tidak menaikkan peristiwa yang Diketuk :

Berlaku untuk

Lihat juga