Fungsi SetCapture (winuser.h)

Artikel
03/04/2024

Menyetel tangkapan mouse ke jendela yang ditentukan milik utas saat ini. SetCapture mengambil input mouse baik ketika mouse berada di atas jendela penangkapan, atau ketika tombol mouse ditekan saat mouse berada di atas jendela penangkapan dan tombol masih turun. Hanya satu jendela pada satu waktu yang dapat menangkap mouse.

Jika kursor mouse berada di atas jendela yang dibuat oleh utas lain, sistem akan mengarahkan input mouse ke jendela yang ditentukan hanya jika tombol mouse tidak berfungsi.

Sintaks

HWND SetCapture(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela di utas saat ini yaitu menangkap mouse.

Nilai kembali

Jenis: HWND

Nilai yang dikembalikan adalah handel ke jendela yang sebelumnya telah mengambil mouse. Jika tidak ada jendela seperti itu, nilai yang dikembalikan adalah NULL.

Keterangan

Hanya jendela latar depan yang dapat menangkap mouse. Ketika jendela latar belakang mencoba melakukannya, jendela hanya menerima pesan untuk peristiwa mouse yang terjadi ketika hot spot kursor berada di dalam bagian jendela yang terlihat. Selain itu, bahkan jika jendela latar depan telah menangkap mouse, pengguna masih dapat mengklik jendela lain, membawanya ke latar depan.

Ketika jendela tidak lagi memerlukan semua input mouse, utas yang membuat jendela harus memanggil fungsi ReleaseCapture untuk melepaskan mouse.

Fungsi ini tidak dapat digunakan untuk menangkap input mouse yang dimaksudkan untuk proses lain.

Saat mouse ditangkap, tombol pintas menu dan akselerator keyboard lainnya tidak berfungsi.

Contoh

Misalnya, lihat Menggambar Garis dengan Mouse.

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	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-mouse-l1-1-0 (diperkenalkan dalam Windows 8)