Fungsi InvalidateRect (winuser.h)
Fungsi InvalidateRect menambahkan persegi ke wilayah pembaruan jendela yang ditentukan. Wilayah pembaruan mewakili bagian area klien jendela yang harus digambar ulang.
Sintaks
BOOL InvalidateRect(
[in] HWND hWnd,
[in] const RECT *lpRect,
[in] BOOL bErase
);
Parameter
[in] hWnd
Handel ke jendela yang wilayah pembaruannya telah berubah. Jika parameter ini NULL, sistem membatalkan dan menggambar ulang semua jendela, bukan hanya jendela untuk aplikasi ini, dan mengirim pesan WM_ERASEBKGND dan WM_NCPAINT sebelum fungsi kembali. Mengatur parameter ini ke NULL tidak disarankan.
[in] lpRect
Penunjuk ke struktur RECT yang berisi koordinat klien persegi panjang yang akan ditambahkan ke wilayah pembaruan. Jika parameter ini NULL, seluruh area klien ditambahkan ke wilayah pembaruan.
[in] bErase
Menentukan apakah latar belakang dalam wilayah pembaruan akan dihapus saat wilayah pembaruan diproses. Jika parameter ini TRUE, latar belakang dihapus saat fungsi BeginPaint dipanggil. Jika parameter ini FALSE, latar belakang tetap tidak berubah.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Area yang tidak valid terakumulasi di wilayah pembaruan hingga wilayah diproses ketika pesan WM_PAINT berikutnya terjadi atau sampai wilayah divalidasi dengan menggunakan fungsi ValidateRect atau ValidateRgn .
Sistem mengirim pesan WM_PAINT ke jendela setiap kali wilayah pembaruannya tidak kosong dan tidak ada pesan lain dalam antrean aplikasi untuk jendela tersebut.
Jika parameter bEraseTRUE untuk bagian mana pun dari wilayah pembaruan, latar belakang dihapus di seluruh wilayah, bukan hanya di bagian yang ditentukan.
Contoh
Misalnya, lihat Membatalkan Area Klien.
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 (termasuk Windows.h) |
| Pustaka | User32.lib |
| DLL | User32.dll |
| Set API | ext-ms-win-ntuser-draw-l1-1-0 (diperkenalkan di Windows 8) |