Bagikan melalui

UIElement.Tapped Kejadian

  • Referensi

Definisi

Ruang nama:
Microsoft.UI.Xaml
Edit

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

TappedEventHandler

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 Tapped mewakili gerakan, sedangkan peristiwa PointerPressed adalah peristiwa input tingkat bawah. Tapped dan PointerPressed peristiwa dapat dimunculkan sebagai hasil dari interaksi pengguna tunggal. Jika sumber peristiwa memiliki ManipulationMode non-default, ManipulationStarting juga dapat dinaikkan. Bahkan jika kontrol sudah menangani PointerPressed dalam logika kontrol, atau menangani manipulasi, itu tidak mencegah Tapped dinaikkan.

Peristiwa Tapped berpotensi menghasilkan lebih dari satu titik penunjuk. Untuk peristiwa gerakan tingkat lebih tinggi seperti Tapped 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.

Tapped adalah peristiwa yang dirutekan. Selain itu, elemen harus memiliki IsTapEnabled menjadi trueTapped sumber peristiwa (true adalah default). Dimungkinkan untuk menangani Tapped pada elemen induk bahkan jika IsTapEnabled ada false di elemen induk, jika peristiwa gelembung ke induk dari elemen anak sumber peristiwa di mana IsTapEnabled adalah false. 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.

Tapped 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 tersebut Tapped . 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.

Tapped dan Holding saling eksklusif. Sistem input harus menunggu sampai titik penunjuk dilepaskan untuk menentukan apakah tindakan harus Tapped, Holding atau beberapa gerakan lain, sehingga Anda tidak mendapatkan Tapped 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 tambahan Tapped. Jika Anda menginginkan logika yang berbeda untuk Tapped versus DoubleTapped, handler Anda Tapped 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 Tapped tindakan. 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 Tapped peristiwa:

Berlaku untuk

Lihat juga