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	Winuser.h

Lihat juga

Konstanta

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE