Fungsi GetWindowRect (winuser.h)

Mengambil dimensi persegi panjang pembatas dari jendela yang ditentukan. Dimensi diberikan dalam koordinat layar yang relatif terhadap sudut kiri atas layar.

Sintaksis

BOOL GetWindowRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect
);

Parameter-parameternya

[in] hWnd

Jenis: HWND

Handel ke jendela.

[out] lpRect

Jenis: LPRECT

Penunjuk ke struktur RECT yang menerima koordinat layar sudut kiri atas dan kanan bawah jendela.

Mengembalikan nilai

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Sesuai dengan konvensi untuk struktur RECT , koordinat kanan bawah persegi panjang yang dikembalikan bersifat eksklusif. Dengan kata lain, piksel di (kanan, bawah) terletak tepat di luar persegi panjang.

GetWindowRect divirtualisasi untuk DPI.

Di Windows Vista dan yang lebih baru, Window Rect sekarang mungkin menyertakan batas perubahan ukuran yang tidak terlihat.

Untuk mendapatkan batas jendela yang terlihat, tidak termasuk batas pengubahan ukuran yang tidak terlihat, gunakan DwmGetWindowAttribute, menentukan DWMWA_EXTENDED_FRAME_BOUNDS. Perhatikan bahwa tidak seperti Window Rect, DWM Extended Frame Bounds tidak disesuaikan untuk DPI.

Contoh

Misalnya, lihat Menginisialisasi Kotak Dialog.

Persyaratan

Persyaratan	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Tajuk	winuser.h (termasuk Windows.h)
Perpustakaan	User32.lib
DLL	User32.dll
set API	ext-ms-win-ntuser-window-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

Konseptual

GetClientRect

Referensi

ScreenToClient

SetWindowPos

Windows