Bagikan melalui


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.

Sintaks

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

Parameter

[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.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

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 menyertakan area yang ditempati oleh bayangan drop.

Memanggil GetWindowRect akan memiliki perilaku yang berbeda tergantung pada apakah jendela pernah ditampilkan atau tidak. Jika jendela belum ditampilkan sebelumnya, GetWindowRect tidak akan menyertakan area bayangan jatuh.

Untuk mendapatkan batas jendela tidak termasuk bayangan jatuh, gunakan DwmGetWindowAttribute, menentukan DWMWA_EXTENDED_FRAME_BOUNDS. Perhatikan bahwa tidak seperti Window Rect, Batas Bingkai Diperpanjang DWM tidak disesuaikan untuk DPI. Mendapatkan batas bingkai yang diperluas hanya dapat dilakukan setelah jendela ditampilkan setidaknya sekali.

Contoh

Misalnya, lihat Menginisialisasi Kotak Dialog.

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-0 (diperkenalkan di Windows 8)

Lihat juga

Konseptual

GetClientRect

Referensi

ScreenToClient

SetWindowPos

Windows