UIElement.PointerWheelChanged Kejadian

  • Referensi

Definisi

Ruang nama:
Windows.UI.Xaml
Edit

Terjadi ketika nilai delta roda penunjuk berubah.

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

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

// Revoke with event_revoker
UIElement::PointerWheelChanged_revoker PointerWheelChanged(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerWheelChanged;
function onPointerWheelChanged(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerwheelchanged", onPointerWheelChanged);
uIElement.removeEventListener("pointerwheelchanged", onPointerWheelChanged);
- or -
uIElement.onpointerwheelchanged = onPointerWheelChanged;
Public Custom Event PointerWheelChanged As PointerEventHandler 
<uielement PointerWheelChanged = "eventhandler" .../>

Jenis Acara

PointerEventHandler

Keterangan

Ketika Anda menangani PointerWheelChanged, Anda biasanya tertarik dengan nilai properti MouseWheelDelta :

  1. Panggil GetCurrentPoint dari PointerRoutedEventArgs yang tersedia untuk handler Anda. Ini mengembalikan PointerPoint.
  2. Dapatkan PropertiPointerPoint. Ini berisi objek PointerPointProperties .
  3. Dapatkan nilai properti MouseWheelDelta dari objek PointerPointProperties . Nilai positif menunjukkan bahwa roda diputar ke depan (menjauh dari pengguna) atau miring ke kanan; nilai negatif menunjukkan bahwa roda diputar mundur (ke arah pengguna) atau miring ke kiri.

Jika elemen tempat peristiwa pointer terjadi memiliki nilai ManipulationMode non-default, tindakan tersebut mungkin juga menghasilkan berbagai peristiwa manipulasi seperti ManipulationStarted. Selain itu, input roda mouse dapat ditangani sebagai perilaku manipulasi bawaan oleh kontrol, bahkan tanpa nilai ManipulationMode yang ditetapkan. Misalnya, kontrol tertentu seperti GridView dan ListView dapat memproses input roda mouse untuk memulai tindakan gulir/pan.

PointerWheelChanged adalah peristiwa yang dirutekan. 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 tes temuan yang terlihat agar menjadi sumber peristiwa dan menembakkan peristiwa yang terkait dengan tindakan. UIElement.Visibility harus Terlihat. Properti lain dari jenis turunan juga memengaruhi visibilitas hit-test. Untuk informasi selengkapnya, lihat Ringkasan peristiwa dan peristiwa yang dirutekan.

PointerWheelChanged mendukung kemampuan untuk melampirkan penanganan aktivitas ke rute yang akan dipanggil bahkan jika data peristiwa untuk peristiwa ditandai Ditangani. Lihat AddHandler.

Kontrol Windows Runtime tertentu mungkin memiliki penanganan berbasis kelas untuk peristiwa input PointerWheelChanged. Jika demikian, kontrol mungkin memiliki penimpaan untuk metode OnPointerWheelChanged. Biasanya peristiwa ditandai ditangani oleh handler kelas, dan peristiwa PointerWheelChanged tidak dinaikkan untuk penanganan oleh penangan kode pengguna apa pun pada kontrol tersebut. Kontrol mungkin melakukan ini untuk mendukung traversal elemen turunannya dengan menggunakan tindakan roda penunjuk. Untuk informasi selengkapnya tentang cara kerja penanganan berbasis kelas untuk peristiwa, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.

Perilaku Windows 8

Untuk Windows 8, gerakan perangkat track pad yang ditangani input oleh bagian kontrol ScrollViewer ditafsirkan sebagai input roda mouse, dan dengan demikian akan menembakkan peristiwa PointerWheelChanged. Dimulai dengan Windows 8.1, ScrollViewer menggunakan logika manipulasi dasar yang menafsirkan gerakan track pad sebagai tindakan yang direspons ScrollViewer , dan dengan demikian gerakan dianggap ditangani oleh kontrol dan peristiwa PointerWheelChanged tidak diaktifkan lagi.

Jika Anda memigrasikan kode aplikasi dari Windows 8 ke Windows 8.1, Anda mungkin ingin memperhitungkan perubahan perilaku ini, karena mengakibatkan PointerWheelChanged diaktifkan dalam kasus yang lebih sedikit. Selain itu, perilaku yang sekarang bawaan scrollViewer mungkin menduplikasi apa yang akan dilakukan handler Anda.

Aplikasi yang dikompilasi untuk Windows 8 tetapi berjalan di Windows 8.1 terus menggunakan perilaku Windows 8.

Berlaku untuk

Lihat juga