Bagikan melalui


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)

Lihat juga

EndPaint

InvalidateRect

InvalidateRgn

STRUKTUR CAT

Fungsi Melukis dan Menggambar

Gambaran Umum Melukis dan Menggambar

ValidateRect

ValidateRgn