Fungsi GetWindowRgn (winuser.h)

  • Artikel

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