Metode IPointerInactive::OnInactiveMouseMove (ocidl.h)

Memberi tahu objek bahwa penunjuk mouse telah bergerak di atasnya sehingga objek dapat menembakkan peristiwa mouse. Metode ini dipanggil oleh kontainer pada penerimaan metode WM_MOUSEMOVE ketika objek tidak aktif berada di bawah penunjuk mouse.

Sintaks

HRESULT OnInactiveMouseMove(
  [in] LPCRECT pRectBounds,
  [in] LONG    x,
  [in] LONG    y,
  [in] DWORD   grfKeyState
);

Parameter

[in] pRectBounds

Persegi panjang pembatas objek, dalam koordinat klien dari jendela yang berisi. Parameter ini memberi tahu objek posisi dan ukuran yang tepat pada layar ketika pesan WM_MOUSEMOVE diterima. Nilai ini ditentukan dalam unit sistem koordinat klien.

[in] x

Koordinat horizontal lokasi mouse dalam satuan jendela klien yang berisi.

[in] y

Koordinat vertikal lokasi mouse dalam satuan jendela klien yang berisi.

[in] grfKeyState

Status tombol pengubah papan ketik saat ini pada papan ketik. Nilai yang mungkin dapat berupa kombinasi dari salah satu nilai MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON, dan MK_RBUTTON.

Mengembalikan nilai

Jika metode berhasil, nilai yang dikembalikan S_OK. Jika tidak, itu E_FAIL.

Keterangan

Kontainer memanggil metode ini untuk memberi tahu objek bahwa penunjuk mouse berada di atas objek setelah memeriksa kebijakan aktivasi objek dengan memanggil metode IPointerInactive::GetActivationPolicy . Jika objek belum meminta untuk diaktifkan di tempat melalui panggilan tersebut, kontainer mengirimkan pesan WM_MOUSEMOVE berikutnya ke objek yang tidak aktif dengan memanggil OnInactiveMouseMove selama penunjuk mouse tetap berada di atas objek. Objek kemudian dapat mengaktifkan peristiwa pemindahan mouse.

Untuk menghindari kesalahan pembulatan dan untuk mempermudah pekerjaan pada pelaksana objek, metode ini mengambil koordinat jendela dalam unit jendela klien yang berisi, yaitu, jendela tempat objek ditampilkan, bukan unit HIMETRIC biasa. Dengan demikian, koordinat dan jalur kode yang sama dapat digunakan ketika objek aktif dan tidak aktif. Koordinat jendela menentukan posisi mouse. Persegi panjang pembatas juga ditentukan dalam sistem koordinat yang sama.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ocidl.h

Lihat juga

IPointerInactive