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
Referensi