Bagikan melalui

pesan WM_NCHITTEST

  • Artikel

Dikirim ke jendela untuk menentukan bagian jendela apa yang sesuai dengan koordinat layar tertentu. Ini dapat terjadi, misalnya, ketika kursor bergerak, ketika tombol mouse ditekan atau dirilis, atau sebagai respons terhadap panggilan ke fungsi seperti WindowFromPoint. Jika mouse tidak ditangkap, pesan dikirim ke jendela di bawah kursor. Jika tidak, pesan dikirim ke jendela yang telah mengambil mouse.

Jendela menerima pesan ini melalui fungsi WindowProc-nya.

#define WM_NCHITTEST                    0x0084

Parameter

wParam

Parameter ini tidak digunakan.

lParam

Kata berurutan rendah menentukan koordinat x kursor. Koordinat relatif terhadap sudut kiri atas layar.

Kata urutan tinggi menentukan koordinat y kursor. Koordinat relatif terhadap sudut kiri atas layar.

Nilai hasil

Nilai pengembalian fungsi DefWindowProc adalah salah satu nilai berikut, menunjukkan posisi hot spot kursor.

Mengembalikan kode/nilai Deskripsi
HTBORDER
18
 Di batas jendela yang tidak memiliki batas ukuran.
HTBOTTOM
15
 Di batas horizontal bawah jendela yang dapat diubah ukurannya (pengguna dapat mengklik mouse untuk mengubah ukuran jendela secara vertikal).
HTBOTTOMLEFT
16
 Di sudut kiri bawah batas jendela yang dapat diubah ukurannya (pengguna dapat mengklik mouse untuk mengubah ukuran jendela secara diagonal).
HTBOTTOMRIGHT
17
 Di sudut kanan bawah batas jendela yang dapat diubah ukurannya (pengguna dapat mengklik mouse untuk mengubah ukuran jendela secara diagonal).
HTCAPTION
2
 Di bilah judul.
HTCLIENT
1
 Di area klien.
HTCLOSE
20
 Di tombol Tutup.
HTERROR
-2
 Pada latar belakang layar atau pada garis pembagian antara jendela (sama dengan HTNOWHERE, kecuali bahwa fungsi DefWindowProc menghasilkan bip sistem untuk menunjukkan kesalahan).
HTGROWBOX
4
 Dalam kotak ukuran (sama dengan HTSIZE).
HTHELP
21
 Di tombol Bantuan.
HTHSCROLL
6
 Di bilah gulir horizontal.
HTLEFT
10
 Di batas kiri jendela yang dapat diubah ukurannya (pengguna dapat mengklik mouse untuk mengubah ukuran jendela secara horizontal).
HTMENU
5
 Di menu.
HTMAXBUTTON
9
 Di tombol Maksimalkan.
HTMINBUTTON
8
 Di tombol Minimalkan.
HTNOWHERE
0
 Pada latar belakang layar atau pada garis pembagian antara jendela.
HTREDUCE
8
 Di tombol Minimalkan.
HTRIGHT
11
 Di batas kanan jendela yang dapat diubah ukurannya (pengguna dapat mengklik mouse untuk mengubah ukuran jendela secara horizontal).
HTSIZE
4
 Dalam kotak ukuran (sama dengan HTGROWBOX).
HTSYSMENU
3
 Di menu jendela atau di tombol Tutup di jendela anak.
HTTOP
12
 Di batas horizontal atas jendela.
HTTOPLEFT
13
 Di sudut kiri atas batas jendela.
HTTOPRIGHT
14
 Di sudut kanan atas batas jendela.
HTTRANSPARENT
-1
 Di jendela yang saat ini dicakup oleh jendela lain dalam utas yang sama (pesan akan dikirim ke jendela yang mendasar dalam utas yang sama sampai salah satunya mengembalikan kode yang bukan HTTRANSPARENT).
HTVSCROLL
7
 Di bilah gulir vertikal.
HTZOOM
9
 Di tombol Maksimalkan.

Keterangan

Gunakan kode berikut untuk mendapatkan posisi horizontal dan vertikal:

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam);

Seperti disebutkan di atas, koordinat x berada dalam kekurangan nilai pengembalian dalam urutan rendah; koordinat y berada dalam pendek urutan tinggi (keduanya mewakili nilai yang ditandatangani karena dapat mengambil nilai negatif pada sistem dengan beberapa monitor). Jika nilai pengembalian ditetapkan ke variabel, Anda dapat menggunakan makro MAKEPOINTS untuk mendapatkan struktur POINTS dari nilai yang dikembalikan. Anda juga dapat menggunakan makro GET_X_LPARAM atau GET_Y_LPARAM untuk mengekstrak koordinat x atau y.

Penting

Jangan gunakan makro LOWORD atau HIWORD untuk mengekstrak koordinat x- dan y- dari posisi kursor karena makro ini mengembalikan hasil yang salah pada sistem dengan beberapa monitor. Sistem dengan beberapa monitor dapat memiliki koordinat x-dan y- negatif, dan LOWORD dan HIWORD memperlakukan koordinat sebagai jumlah yang tidak ditandatangani.

Windows Vista: Saat membuat bingkai kustom yang menyertakan tombol keterangan standar, pesan ini harus terlebih dahulu diteruskan ke fungsi DwmDefWindowProc . Ini memungkinkan Desktop Window Manager (DWM) untuk menyediakan pengujian hit untuk tombol keterangan. Jika DwmDefWindowProc tidak menangani pesan, pemrosesan lebih lanjut WM_NCHITTEST mungkin diperlukan.

Persyaratan

Persyaratan Value
Klien minimum yang didukung
 Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung
 Windows 2000 Server [hanya aplikasi desktop]
Header
Winuser.h (termasuk Windowsx.h)

Baca juga

Referensi

DefWindowProc

GET_X_LPARAM

GET_Y_LPARAM

Konseptual

Mouse Input

Sumber Daya Lainnya

MAKEPOINTS

POIN