Struktur TRACKMOUSEEVENT (winuser.h)

  • Artikel

Digunakan oleh fungsi TrackMouseEvent untuk melacak kapan penunjuk mouse meninggalkan jendela atau mengarahkan kursor ke jendela untuk jangka waktu tertentu.

Sintaks

typedef struct tagTRACKMOUSEEVENT {
  DWORD cbSize;
  DWORD dwFlags;
  HWND  hwndTrack;
  DWORD dwHoverTime;
} TRACKMOUSEEVENT, *LPTRACKMOUSEEVENT;

Anggota

cbSize

Jenis: DWORD

Ukuran struktur TRACKMOUSEEVENT , dalam byte.

dwFlags

Jenis: DWORD

Layanan yang diminta. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai Makna
TME_CANCEL
0x80000000
 Pemanggil ingin membatalkan permintaan pelacakan sebelumnya. Penelepon juga harus menentukan jenis pelacakan yang ingin dibatalkan. Misalnya, untuk membatalkan pelacakan hover, pemanggil harus meneruskan bendera TME_CANCEL dan TME_HOVER .
TME_HOVER
0x00000001
 Penelepon menginginkan pemberitahuan hover. Pemberitahuan dikirimkan sebagai pesan WM_MOUSEHOVER .

Jika penelepon meminta pelacakan hover saat pelacakan hover sudah aktif, timer hover akan diatur ulang.

Bendera ini diabaikan jika penunjuk mouse tidak berada di atas jendela atau area yang ditentukan.
TME_LEAVE
0x00000002
 Penelepon ingin meninggalkan pemberitahuan. Pemberitahuan dikirimkan sebagai pesan WM_MOUSELEAVE . Jika mouse tidak berada di atas jendela atau area yang ditentukan, pemberitahuan cuti akan segera dibuat dan tidak ada pelacakan lebih lanjut yang dilakukan.
TME_NONCLIENT
0x00000010
 Penelepon ingin mengarahkan mouse ke atas dan meninggalkan pemberitahuan untuk area nonkelola. Pemberitahuan dikirimkan sebagai pesan WM_NCMOUSEHOVER dan WM_NCMOUSELEAVE .
TME_QUERY
0x40000000
 Fungsi ini mengisi struktur alih-alih memperlakukannya sebagai permintaan pelacakan. Struktur diisi sedih sehingga struktur yang telah diteruskan ke TrackMouseEvent, itu akan menghasilkan pelacakan saat ini. Satu-satunya anomali adalah bahwa batas waktu hover yang dikembalikan selalu waktu habis aktual dan tidak HOVER_DEFAULT, jika HOVER_DEFAULT ditentukan selama permintaan TrackMouseEvent asli.

hwndTrack

Jenis: HWND

Handel ke jendela untuk dilacak.

dwHoverTime

Jenis: DWORD

Batas waktu hover (jika TME_HOVER ditentukan dalam dwFlags), dalam milidetik. Dapat HOVER_DEFAULT, yang berarti menggunakan batas waktu hover default sistem.

Keterangan

Batas waktu hover default sistem pada awalnya adalah waktu drop-down menu, yaitu 400 milidetik. Anda dapat memanggil SystemParametersInfo dan menggunakan SPI_GETMOUSEHOVERTIME untuk mengambil batas waktu hover default.

Persegi panjang hover default sistem sama dengan persegi panjang klik ganda. Anda dapat memanggil SystemParametersInfo dan menggunakan SPI_GETMOUSEHOVERWIDTH dan SPI_GETMOUSEHOVERHEIGHT untuk mengambil ukuran persegi panjang di mana pointer mouse harus tetap berada agar TrackMouseEvent menghasilkan pesan WM_MOUSEHOVER .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header winuser.h (sertakan Windows.h)

Lihat juga

Mouse Input