Bagikan melalui


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)

Lihat juga

BeginPaint

InvalidateRgn

Fungsi Melukis dan Menggambar

Gambaran Umum Melukis dan Menggambar

RECT

ValidateRect

ValidateRgn

WM_ERASEBKGND

WM_NCPAINT

WM_PAINT