Fungsi GetUpdateRect (winuser.h)

Artikel
08/27/2023

Fungsi GetUpdateRect mengambil koordinat persegi terkecil yang sepenuhnya menutupi wilayah pembaruan dari jendela yang ditentukan. GetUpdateRect mengambil persegi panjang dalam koordinat logis. Jika tidak ada wilayah pembaruan, GetUpdateRect mengambil persegi panjang kosong (mengatur semua koordinat ke nol).

Sintaks

BOOL GetUpdateRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect,
  [in]  BOOL   bErase
);

Parameter

[in] hWnd

Tangani ke jendela yang wilayah pembaruannya akan diambil.

[out] lpRect

Arahkan ke struktur RECT yang menerima koordinat, dalam unit perangkat, dari persegi panjang yang tertutup.

Aplikasi dapat mengatur parameter ini ke NULL untuk menentukan apakah ada wilayah pembaruan untuk jendela. Jika parameter ini NULL, GetUpdateRect mengembalikan nonzero jika ada wilayah pembaruan, dan nol jika tidak ada. Ini menyediakan cara yang sederhana dan efisien untuk menentukan apakah pesan WM_PAINT dihasilkan dari area yang tidak valid.

[in] bErase

Menentukan apakah latar belakang di wilayah pembaruan akan dihapus. Jika parameter ini TRUE dan wilayah pembaruan tidak kosong, GetUpdateRect mengirimkan pesan WM_ERASEBKGND ke jendela yang ditentukan untuk menghapus latar belakang.

Mengembalikan nilai

Jika wilayah pembaruan tidak kosong, nilai yang dikembalikan bukan nol.

Jika tidak ada wilayah pembaruan, nilai yang dikembalikan adalah nol.

Keterangan

Persegi panjang pembaruan yang diambil oleh fungsi BeginPaint identik dengan yang diambil oleh GetUpdateRect.

BeginPaint secara otomatis memvalidasi wilayah pembaruan, sehingga setiap panggilan ke GetUpdateRect yang dilakukan segera setelah panggilan ke BeginPaint mengambil wilayah pembaruan kosong.

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)