Fungsi InvalidateRgn (winuser.h)

Artikel
03/04/2024

Fungsi InvalidateRgn membatalkan area klien dalam wilayah yang ditentukan dengan menambahkannya ke wilayah pembaruan jendela saat ini. Wilayah yang tidak valid, bersama dengan semua area lain di wilayah pembaruan, ditandai untuk pengecatan ketika pesan WM_PAINT berikutnya terjadi.

Sintaks

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

Parameter

[in] hWnd

Handel ke jendela dengan wilayah pembaruan yang akan dimodifikasi.

[in] hRgn

Handel ke wilayah yang akan ditambahkan ke wilayah pembaruan. Wilayah diasumsikan memiliki koordinat klien. Jika parameter ini NULL, seluruh area klien ditambahkan ke wilayah pembaruan.

[in] bErase

Menentukan apakah latar belakang dalam wilayah pembaruan harus dihapus saat wilayah pembaruan diproses. Jika parameter ini TRUE, latar belakang dihapus saat fungsi BeginPaint dipanggil. Jika parameter false, latar belakang tetap tidak berubah.

Nilai kembali

Nilai yang dikembalikan selalu bukan nol.

Keterangan

Area yang tidak valid terakumulasi di wilayah pembaruan hingga pesan WM_PAINT berikutnya diproses atau hingga 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.

Wilayah yang ditentukan harus dibuat dengan menggunakan salah satu fungsi wilayah.

Jika parameter bEraseTRUE untuk bagian mana pun dari wilayah pembaruan, latar belakang di seluruh wilayah dihapus, bukan hanya di bagian yang ditentukan.

Persyaratan

Persyaratan	Nilai
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 dalam Windows 8)