Fungsi GetWindowRgnBox (winuser.h)

Artikel
03/13/2024

Fungsi GetWindowRgnBox mengambil dimensi persegi panjang pembatas terketat untuk wilayah jendela jendela.

Sintaks

int GetWindowRgnBox(
  [in]  HWND   hWnd,
  [out] LPRECT lprc
);

Parameter

[in] hWnd

Tangani ke jendela.

[out] lprc

Penunjuk ke struktur RECT yang menerima dimensi persegi panjang, di unit perangkat relatif terhadap sudut kiri atas jendela.

Nilai kembali

Nilai yang dikembalikan menentukan jenis wilayah yang diperoleh fungsi. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
COMPLEXREGION	Wilayah ini lebih dari satu persegi panjang.
KESALAHAN	Jendela yang ditentukan tidak memiliki wilayah, atau terjadi kesalahan saat mencoba mengembalikan wilayah.
NULLREGION	Wilayah ini kosong.
SIMPLEREGION	Wilayah ini adalah persegi panjang tunggal.

Keterangan

Wilayah jendela menentukan area di dalam jendela tempat sistem mengizinkan gambar. Sistem tidak menampilkan bagian mana pun dari jendela yang terletak di luar wilayah jendela. Koordinat wilayah jendela relatif terhadap sudut kiri atas jendela, bukan area klien jendela.

Untuk mengatur wilayah jendela jendela, panggil fungsi SetWindowRgn .

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 (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-draw-l1-1-0 (diperkenalkan dalam Windows 8)