Fungsi ClientToScreen (winuser.h)

Artikel
08/27/2023

Fungsi ClientToScreen mengonversi koordinat area klien dari titik tertentu ke koordinat layar.

Sintaks

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

Parameter

[in] hWnd

Handel ke jendela yang area kliennya digunakan untuk konversi.

[in, out] lpPoint

Penunjuk ke struktur POINT yang berisi koordinat klien yang akan dikonversi. Koordinat layar baru disalin ke dalam struktur ini jika fungsi berhasil.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Fungsi ClientToScreen menggantikan koordinat area klien dalam struktur POINT dengan koordinat layar. Koordinat layar relatif terhadap sudut kiri atas layar. Perhatikan, titik koordinat layar yang berada di atas area klien jendela memiliki koordinat y negatif. Demikian pula, koordinat layar di sebelah kiri area klien memiliki koordinat x negatif.

Semua koordinat adalah koordinat perangkat.

Contoh

Misalnya, lihat "Menggambar Garis dengan Mouse" di Menggunakan Input 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 (sertakan 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)