Fungsi BeginPaint (winuser.h)

Artikel
03/15/2023

Fungsi BeginPaint menyiapkan jendela yang ditentukan untuk melukis dan mengisi struktur PAINTSTRUCT dengan informasi tentang lukisan.

Sintaks

HDC BeginPaint(
  [in]  HWND          hWnd,
  [out] LPPAINTSTRUCT lpPaint
);

Parameter

[in] hWnd

Tangani ke jendela yang akan dicat ulang.

[out] lpPaint

Arahkan ke struktur PAINTSTRUCT yang akan menerima informasi lukisan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke konteks perangkat tampilan untuk jendela yang ditentukan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL, menunjukkan bahwa tidak ada konteks perangkat tampilan yang tersedia.

Keterangan

Fungsi BeginPaint secara otomatis mengatur wilayah kliping konteks perangkat untuk mengecualikan area apa pun di luar wilayah pembaruan. Wilayah pembaruan diatur oleh fungsi InvalidateRect atau InvalidateRgn dan oleh sistem setelah mengukur, memindahkan, membuat, menggulir, atau operasi lain yang memengaruhi area klien. Jika wilayah pembaruan ditandai untuk dihapus, BeginPaint akan mengirim pesan WM_ERASEBKGND ke jendela.

Aplikasi tidak boleh memanggil BeginPaint kecuali sebagai respons terhadap pesan WM_PAINT . Setiap panggilan ke BeginPaint harus memiliki panggilan yang sesuai ke fungsi EndPaint .

Jika tanda sisipan berada di area yang akan dicat, BeginPaint secara otomatis menyembunyikan tanda sisipan untuk mencegahnya dihapus.

Jika kelas jendela memiliki kuas latar belakang, BeginPaint menggunakan kuas tersebut untuk menghapus latar belakang wilayah pembaruan sebelum kembali.

Virtualisasi DPI

API ini tidak berpartisipasi dalam virtualisasi DPI. Output yang dikembalikan selalu dalam hal piksel fisik.

Contoh

Misalnya, lihat Menggambar di Area Klien.

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)