Fungsi GetWindowRect (winuser.h)

Artikel
08/27/2023

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)