UIElement.PointerCanceled Kejadian

  • Referensi

Definisi

Ruang nama:
Windows.UI.Xaml
Edit

Terjadi ketika pointer yang membuat kontak secara tidak normal kehilangan kontak.

public:
 virtual event PointerEventHandler ^ PointerCanceled;
// Register
event_token PointerCanceled(PointerEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::PointerCanceled_revoker PointerCanceled(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerCanceled;
function onPointerCanceled(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointercanceled", onPointerCanceled);
uIElement.removeEventListener("pointercanceled", onPointerCanceled);
- or -
uIElement.onpointercanceled = onPointerCanceled;
Public Custom Event PointerCanceled As PointerEventHandler 
<uiElement PointerCanceled="eventhandler"/>

Jenis Acara

PointerEventHandler

Keterangan

Beberapa alasan mengapa Anda mungkin mendapatkan kejadian PointerCanceled adalah:

  • Tindakan pengguna yang mengubah hubungan area tampilan, seperti mengubah resolusi atau memantau pengaturan
  • Interaksi input seperti stylus menyentuh permukaan yang sama dengan tindakan sentuhan sebelumnya
  • Pengguna keluar atau gangguan serupa yang tidak spesifik untuk aplikasi
  • Jumlah kontak simultan melebihi nomor yang didukung oleh perangkat

Penting

PointerCanceled mungkin diaktifkan alih-alih PointerReleased. Jangan mengandalkan peristiwa PointerPressed dan PointerReleased selalu terjadi secara berpasangan. Agar berfungsi dengan baik, aplikasi Anda harus mendengarkan dan menangani semua peristiwa yang mewakili kemungkinan kesimpulan tindakan Tekan , dan yang mencakup PointerCanceled.

Jika PointerCanceled diaktifkan, penunjuk apa pun yang ditangkap oleh pointer tersebut akan dilepaskan. Untuk informasi selengkapnya tentang penangkapan pointer, lihat CapturePointer.

Saat menangani peristiwa PointerCanceled, antisipasi bahwa beberapa data peristiwa yang biasanya tersedia untuk peristiwa pointer tidak akan bermakna di objek PointerRoutedEventArgs yang Anda dapatkan melalui handler Anda. Misalnya, Posisi penunjuk tidak valid karena penunjuk tidak ada lagi.

PointerCanceled adalah peristiwa yang dirutekan. Untuk informasi selengkapnya tentang konsep peristiwa yang dirutekan, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.

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

Berlaku untuk

Lihat juga