Fungsi ScreenToClient (winuser.h)

Fungsi ScreenToClient mengonversi koordinat layar dari titik tertentu pada layar menjadi koordinat area klien.

Sintaks

BOOL ScreenToClient(
  [in] HWND    hWnd,
       LPPOINT lpPoint
);

Parameter

[in] hWnd

Handel ke jendela yang area kliennya akan digunakan untuk konversi.

lpPoint

Penunjuk ke struktur POINT yang menentukan koordinat layar yang akan dikonversi.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Fungsi ini menggunakan jendela yang diidentifikasi oleh parameter hWnd dan koordinat layar yang diberikan dalam struktur POINT untuk menghitung koordinat klien. Kemudian menggantikan koordinat layar dengan koordinat klien. Koordinat baru relatif terhadap sudut kiri atas area klien jendela yang ditentukan.

Fungsi ScreenToClient mengasumsikan titik yang ditentukan berada dalam koordinat layar.

Semua koordinat berada dalam unit perangkat.

Jangan gunakan ScreenToClient saat dalam situasi pencerminan, yaitu, saat mengubah dari tata letak kiri-ke-kanan ke tata letak kanan-ke-kiri. Sebagai gantinya, gunakan MapWindowPoints. Untuk informasi selengkapnya, lihat "Tata Letak dan Pencerminan Jendela" di Fitur Jendela.

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

Lihat juga

ClientToScreen

Fungsi Ruang Koordinat dan Transformasi

Gambaran Umum Ruang Koordinat dan Transformasi

MapWindowPoints

TITIK