Fungsi ChildWindowFromPoint (winuser.h)

Artikel
03/15/2023

Menentukan mana, jika ada, dari jendela anak milik jendela induk yang berisi titik yang ditentukan. Pencarian dibatasi untuk jendela turunan segera. Cucu, dan jendela turunan yang lebih dalam tidak dicari.

Untuk melewati jendela anak tertentu, gunakan fungsi ChildWindowFromPointEx .

Sintaks

HWND ChildWindowFromPoint(
  [in] HWND  hWndParent,
  [in] POINT Point
);

Parameter

[in] hWndParent

Jenis: HWND

Handel ke jendela induk.

[in] Point

Jenis: TITIK

Struktur yang menentukan koordinat klien, relatif terhadap hWndParent, dari titik yang akan diperiksa.

Nilai kembali

Jenis: HWND

Nilai yang dikembalikan adalah handel ke jendela anak yang berisi titik, meskipun jendela anak disembunyikan atau dinonaktifkan. Jika titik terletak di luar jendela induk, nilai yang dikembalikan adalah NULL. Jika titik berada di dalam jendela induk tetapi tidak dalam jendela turunan apa pun, nilai yang dikembalikan adalah handel ke jendela induk.

Keterangan

Sistem mempertahankan daftar internal, yang berisi handel jendela anak yang terkait dengan jendela induk. Urutan handel dalam daftar tergantung pada urutan Z jendela anak. Jika lebih dari satu jendela anak berisi titik yang ditentukan, sistem mengembalikan handel ke jendela pertama dalam daftar yang berisi titik.

ChildWindowFromPoint memperlakukan area HTTRANSPARENT dari kontrol standar yang sama dengan bagian kontrol lainnya. Sebaliknya, RealChildWindowFromPoint memperlakukan area HTTRANSPARENT secara berbeda; mengembalikan jendela anak di belakang area transparan kontrol. Misalnya, jika titik berada di area transparan kotak grup, ChildWindowFromPoint mengembalikan kotak grup sementara RealChildWindowFromPoint mengembalikan jendela anak di belakang kotak grup. Namun, kedua API mengembalikan bidang statis, meskipun juga mengembalikan HTTRANSPARENT.

Contoh

Misalnya, lihat "Membuat Toolbar Kotak Kombo" di Menggunakan Kotak Kombo.

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-window-l1-1-4 (diperkenalkan dalam Windows 10, versi 10.0.14393)