Fungsi ValidateRgn (winuser.h)

Artikel
03/04/2024

Fungsi ValidateRgn memvalidasi area klien dalam suatu wilayah dengan menghapus wilayah dari wilayah pembaruan saat ini dari jendela yang ditentukan.

Sintaks

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

Parameter

[in] hWnd

Tangani ke jendela yang wilayah pembaruannya akan dimodifikasi.

[in] hRgn

Menangani ke wilayah yang menentukan area yang akan dihapus dari wilayah pembaruan. Jika parameter ini NULL, seluruh area klien akan dihapus.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Wilayah yang ditentukan harus dibuat oleh fungsi wilayah. Koordinat wilayah diasumsikan sebagai koordinat klien.

Fungsi BeginPaint secara otomatis memvalidasi seluruh area klien. Fungsi ValidateRect atau ValidateRgn tidak boleh dipanggil jika sebagian wilayah pembaruan harus divalidasi sebelum pesan WM_PAINT berikutnya dibuat.

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)