Fungsi BeginPaint (winuser.h)
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) |