Fungsi GetUpdateRgn (winuser.h)

  • Artikel

Fungsi GetUpdateRgn mengambil wilayah pembaruan jendela dengan menyalinnya ke wilayah yang ditentukan. Koordinat wilayah pembaruan relatif terhadap sudut kiri atas jendela (yaitu, mereka adalah koordinat klien).

Sintaks

int GetUpdateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bErase
);

Parameter

[in] hWnd

Tangani ke jendela dengan wilayah pembaruan yang akan diambil.

[in] hRgn

Tangani ke wilayah untuk menerima wilayah pembaruan.

[in] bErase

Menentukan apakah latar belakang jendela harus dihapus dan apakah area jendela anak yang tidak tertutup harus digambar. Jika parameter ini FALSE, tidak ada gambar yang dilakukan.

Menampilkan nilai

Nilai yang dikembalikan menunjukkan kompleksitas wilayah yang dihasilkan; bisa menjadi salah satu nilai berikut.

Nilai Makna
COMPLEXREGION Wilayah terdiri dari lebih dari satu persegi panjang.
KESALAHAN Terjadi kesalahan.
NULLREGION Wilayah kosong.
SIMPLEREGION Wilayah adalah persegi panjang tunggal.

Keterangan

Fungsi BeginPaint secara otomatis memvalidasi wilayah pembaruan, jadi setiap panggilan ke GetUpdateRgn yang dilakukan segera setelah panggilan ke BeginPaint mengambil wilayah pembaruan kosong.

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-0 (diperkenalkan di Windows 8)

Lihat juga

Fungsi Melukis dan Menggambar

Gambaran Umum Melukis dan Menggambar