Fungsi GetWindowRgn (winuser.h)

Artikel
03/15/2023

Fungsi GetWindowRgn mendapatkan salinan wilayah jendela jendela. Wilayah jendela jendela diatur dengan memanggil fungsi SetWindowRgn . 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

Sintaks

int GetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

Parameter

[in] hWnd

Tangani ke jendela yang wilayah jendelanya akan diperoleh.

[in] hRgn

Tangani ke wilayah yang akan dimodifikasi untuk mewakili wilayah jendela.

Menampilkan nilai

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

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

Keterangan

Koordinat wilayah jendela relatif terhadap sudut kiri atas jendela, bukan area klien jendela.

Untuk mengatur wilayah jendela jendela, panggil fungsi SetWindowRgn .

Contoh

Kode berikut menunjukkan cara Anda meneruskan handel wilayah yang sudah ada.


HRGN hrgn = CreateRectRgn(0,0,0,0);
int regionType = GetWindowRgn(hwnd, hrgn);
if (regionType != ERROR) 
{ 
/* hrgn contains window region */ 
}
DeleteObject(hrgn); /* finished with region */

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 (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-draw-l1-1-2 (diperkenalkan dalam Windows 10, versi 10.0.10240)

Lihat juga

Fungsi Melukis dan Menggambar

Gambaran Umum Melukis dan Menggambar

SetWindowRgn

Bagikan melalui