Fungsi TrackMouseEvent (winuser.h)

Artikel
08/28/2023

Memposting pesan saat penunjuk mouse meninggalkan jendela atau mengarahkan kursor ke jendela selama jangka waktu tertentu.

Catatan Fungsi _TrackMouseEvent memanggil TrackMouseEvent jika ada, jika tidak , _TrackMouseEvent meniru TrackMouseEvent.

Sintaks

BOOL TrackMouseEvent(
  [in, out] LPTRACKMOUSEEVENT lpEventTrack
);

Parameter

[in, out] lpEventTrack

Jenis: LPTRACKMOUSEEVENT

Penunjuk ke struktur TRACKMOUSEEVENT yang berisi informasi pelacakan.

Menampilkan nilai

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol .

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Penunjuk mouse dianggap mengarahkan kursor saat tetap berada dalam persegi panjang tertentu untuk jangka waktu tertentu. Panggil SystemParametersInfo. dan gunakan nilai SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT, dan SPI_GETMOUSEHOVERTIME untuk mengambil ukuran persegi panjang dan waktu.

Fungsi ini dapat memposting pesan berikut.

Pesan	Deskripsi
WM_NCMOUSEHOVER	Arti yang sama seperti WM_MOUSEHOVER kecuali ini untuk area nonkelola jendela.
WM_NCMOUSELEAVE	Arti yang sama seperti WM_MOUSELEAVE kecuali ini untuk area nonkelola jendela.
WM_MOUSEHOVER	Mouse mengarahkan kursor ke area klien jendela untuk jangka waktu yang ditentukan dalam panggilan sebelumnya ke TrackMouseEvent. Pelacakan hover berhenti ketika pesan ini dibuat. Aplikasi harus memanggil TrackMouseEvent lagi jika memerlukan pelacakan lebih lanjut dari perilaku hover mouse.
WM_MOUSELEAVE	Mouse meninggalkan area klien jendela yang ditentukan dalam panggilan sebelumnya ke TrackMouseEvent. Semua pelacakan yang diminta oleh TrackMouseEvent dibatalkan ketika pesan ini dibuat. Aplikasi harus memanggil TrackMouseEvent ketika mouse masuk kembali ke jendelanya jika memerlukan pelacakan lebih lanjut dari perilaku hover mouse.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-mouse-l1-1-0 (diperkenalkan di Windows 8)