Bendera Penunjuk
Nilai yang bisa muncul di bidang pointerFlags dari struktur POINTER_INFO .
-
POINTER_FLAG_NONE
-
-
0x00000000
-
Default
-
-
POINTER_FLAG_NEW
-
-
0x00000001
-
Menunjukkan kedatangan pointer baru.
-
-
POINTER_FLAG_INRANGE
-
-
0x00000002
-
Menunjukkan bahwa penunjuk ini terus ada. Ketika bendera ini tidak diatur, itu menunjukkan penunjuk telah meninggalkan rentang deteksi.
Bendera ini biasanya tidak diatur hanya ketika penunjuk melayang meninggalkan rentang deteksi (POINTER_FLAG_UPDATE diatur) atau ketika penunjuk kontak dengan permukaan jendela meninggalkan rentang deteksi (POINTER_FLAG_UP diatur).
-
-
POINTER_FLAG_INCONTACT
-
-
0x00000004
-
Menunjukkan bahwa penunjuk ini bersentuhan dengan permukaan digitizer. Ketika bendera ini tidak diatur, bendera menunjukkan penunjuk melayang.
-
-
POINTER_FLAG_FIRSTBUTTON
-
-
0x00000010
-
Menunjukkan tindakan utama, dianalogikan dengan tombol mouse kiri ke bawah.
Penunjuk sentuh memiliki bendera ini yang diatur saat bersentuhan dengan permukaan digitizer.
Penunjuk pena memiliki bendera ini yang diatur ketika bersentuhan dengan permukaan digitizer tanpa tombol yang ditekan.
Penunjuk mouse memiliki bendera ini yang diatur ketika tombol mouse kiri tidak berfungsi.
-
-
POINTER_FLAG_SECONDBUTTON
-
-
0x00000020
-
Menunjukkan tindakan sekunder, dianalogikan dengan tombol kanan mouse ke bawah.
Penunjuk sentuh tidak menggunakan bendera ini.
Penunjuk pena memiliki bendera ini diatur ketika bersentuhan dengan permukaan digitizer dengan tombol barel pena ditekan.
Penunjuk mouse memiliki bendera ini yang diatur ketika tombol kanan mouse tidak berfungsi.
-
-
POINTER_FLAG_THIRDBUTTON
-
-
0x00000040
-
Analog dengan tombol roda mouse ke bawah.
Penunjuk sentuh tidak menggunakan bendera ini.
Penunjuk pena tidak menggunakan bendera ini.
Penunjuk mouse memiliki bendera ini yang diatur ketika tombol roda mouse tidak berfungsi.
-
-
POINTER_FLAG_FOURTHBUTTON
-
-
0x00000080
-
Analog dengan tombol mouse diperluas pertama (XButton1) ke bawah.
Penunjuk sentuh tidak menggunakan bendera ini.
Penunjuk pena tidak menggunakan bendera ini.
Penunjuk mouse memiliki bendera ini yang diatur ketika tombol tetikus diperluas pertama (XBUTTON1) tidak berfungsi.
-
-
POINTER_FLAG_FIFTHBUTTON
-
-
0x00000100
-
Analog dengan tombol tetikus diperluas kedua (XButton2) ke bawah.
Penunjuk sentuh tidak menggunakan bendera ini.
Penunjuk pena tidak menggunakan bendera ini.
Penunjuk mouse memiliki bendera ini yang diatur ketika tombol tetikus diperluas kedua (XBUTTON2) tidak berfungsi.
-
-
POINTER_FLAG_PRIMARY
-
-
0x00002000
-
Menunjukkan bahwa penunjuk ini telah ditetapkan sebagai penunjuk utama. Pointer utama adalah penunjuk tunggal yang dapat melakukan tindakan di luar yang tersedia untuk pointer non-primer. Misalnya, ketika pointer utama melakukan kontak dengan permukaan jendela s, itu dapat memberikan jendela kesempatan untuk mengaktifkan dengan mengirimkannya pesan WM_POINTERACTIVATE .
Pointer utama diidentifikasi dari semua interaksi pengguna saat ini pada sistem (mouse, sentuhan, pena, dan sebagainya). Dengan demikian, penunjuk utama mungkin tidak dikaitkan dengan aplikasi Anda. Kontak pertama dalam interaksi multi-sentuh diatur sebagai penunjuk utama. Setelah pointer utama diidentifikasi, semua kontak harus diangkat sebelum kontak baru dapat diidentifikasi sebagai penunjuk utama. Untuk aplikasi yang tidak memproses input pointer, hanya peristiwa pointer utama yang dipromosikan ke peristiwa mouse.
-
-
POINTER_FLAG_CONFIDENCE
-
-
0x000004000
-
Keyakinan adalah saran dari perangkat sumber tentang apakah pointer mewakili interaksi yang dimaksudkan atau tidak disengaja, yang sangat relevan untuk PT_TOUCH pointer di mana interaksi yang tidak disengaja (seperti dengan telapak tangan) dapat memicu input. Kehadiran bendera ini menunjukkan bahwa perangkat sumber memiliki keyakinan tinggi bahwa input ini adalah bagian dari interaksi yang dimaksudkan.
-
-
POINTER_FLAG_CANCELED
-
-
0x000008000
-
Menunjukkan bahwa pointer berangkat dengan cara yang tidak normal, seperti ketika sistem menerima input yang tidak valid untuk pointer atau ketika perangkat dengan pointer aktif berangkat secara tiba-tiba. Jika aplikasi yang menerima input berada dalam posisi untuk melakukannya, aplikasi harus memperlakukan interaksi sebagai tidak selesai dan membalikkan efek apa pun dari pointer yang bersangkutan.
-
-
POINTER_FLAG_DOWN
-
-
0x00010000
-
Menunjukkan bahwa penunjuk ini beralih ke status tidak berfungsi; yaitu, melakukan kontak dengan permukaan digitizer.
-
-
POINTER_FLAG_UPDATE
-
-
0x00020000
-
Menunjukkan bahwa ini adalah pembaruan sederhana yang tidak menyertakan perubahan status penunjuk.
-
-
POINTER_FLAG_UP
-
-
0x00040000
-
Menunjukkan bahwa penunjuk ini beralih ke status naik; yaitu, kontak dengan permukaan digitizer berakhir.
-
-
POINTER_FLAG_WHEEL
-
-
0x00080000
-
Menunjukkan input yang terkait dengan roda penunjuk. Untuk penunjuk mouse, ini setara dengan aksi roda gulir mouse (WM_MOUSEHWHEEL).
-
-
POINTER_FLAG_HWHEEL
-
-
0x00100000
-
Menunjukkan input yang terkait dengan penunjuk h-wheel. Untuk penunjuk mouse, ini setara dengan aksi roda gulir horizontal mouse (WM_MOUSEHWHEEL).
-
-
POINTER_FLAG_CAPTURECHANGED
-
-
0x00200000
-
Menunjukkan bahwa penunjuk ini ditangkap oleh (terkait dengan) elemen lain dan elemen asli telah kehilangan tangkapan (lihat WM_POINTERCAPTURECHANGED).
-
-
POINTER_FLAG_HASTRANSFORM
-
-
0x00400000
-
Menunjukkan bahwa penunjuk ini memiliki transformasi terkait.
-
Keterangan
XBUTTON1 dan XBUTTON2 adalah tombol tambahan yang digunakan pada banyak perangkat mouse. Mereka mengembalikan data yang sama dengan tombol mouse standar.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows 8 [khusus aplikasi desktop] |
Server minimum yang didukung |
Windows Server 2012 [hanya aplikasi desktop] |
Header |
|
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