Fungsi GetUpdateRgn (winuser.h)
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) |