UIElement.PointerCanceled Kejadian
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
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 PointerPressed danPointerReleased
peristiwa selalu terjadi berpasangan. Agar berfungsi dengan baik, aplikasi Anda harus mendengarkan dan menangani semua peristiwa yang mewakili kemungkinan kesimpulan tindakan Tekan , dan itu termasukPointerCanceled
.
Jika PointerCanceled
diaktifkan, penunjuk apa pun yang ditangkap oleh pointer tersebut akan dilepaskan. Untuk informasi selengkapnya tentang penangkapan pointer, lihat CapturePointer.
Saat menangani PointerCanceled
peristiwa, antisipasi bahwa beberapa data peristiwa yang biasanya tersedia untuk peristiwa pointer tidak akan bermakna di objek PointerRoutedEventArgs yang Anda dapatkan melalui handler Anda. Misalnya, Microsoft.UI.Input.PointerPoint.Position penunjuk tidak valid karena pointer 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk