Fungsi ValidateRect (winuser.h)

Artikel
03/15/2023

Fungsi ValidateRect memvalidasi area klien dalam persegi panjang dengan menghapus persegi panjang dari wilayah pembaruan jendela yang ditentukan.

Sintaks

BOOL ValidateRect(
  [in] HWND       hWnd,
  [in] const RECT *lpRect
);

Parameter

[in] hWnd

Tangani ke jendela yang wilayah pembaruannya akan dimodifikasi. Jika parameter ini NULL, sistem membatalkan dan menggambar ulang semua jendela dan mengirim pesan WM_ERASEBKGND dan WM_NCPAINT ke prosedur jendela sebelum fungsi kembali.

[in] lpRect

Penunjuk ke struktur RECT yang berisi koordinat klien persegi panjang yang akan dihapus dari wilayah pembaruan. Jika parameter ini NULL, seluruh area klien akan dihapus.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

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

Sistem terus menghasilkan pesan WM_PAINT hingga wilayah pembaruan saat ini divalidasi.

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 (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-draw-l1-1-0 (diperkenalkan di Windows 8)