Fungsi InvalidateRect (winuser.h)

Artikel
08/27/2023

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)