Fungsi PrintWindow (winuser.h)

Artikel
08/27/2023

Fungsi PrintWindow menyalin jendela visual ke dalam konteks perangkat (DC) yang ditentukan, biasanya DC printer.

Sintaks

BOOL PrintWindow(
  HWND hwnd,
  HDC  hdcBlt,
  UINT nFlags
);

Parameter

hwnd

Handel ke jendela yang akan disalin.

hdcBlt

Handel ke konteks perangkat.

nFlags

Opsi menggambar. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
PW_CLIENTONLY	Hanya area klien jendela yang disalin ke hdcBlt. Secara default, seluruh jendela disalin.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan nilai bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol.

Keterangan

Catatan Ini adalah fungsi pemblokiran atau sinkron dan mungkin tidak segera kembali. Seberapa cepat fungsi ini kembali tergantung pada faktor run-time seperti status jaringan, konfigurasi server cetak, dan implementasi driver printer—faktor-faktor yang sulit diprediksi saat menulis aplikasi. Memanggil fungsi ini dari utas yang mengelola interaksi dengan antarmuka pengguna dapat membuat aplikasi tampak tidak responsif.

Aplikasi yang memiliki jendela yang direferensikan oleh hWnd memproses panggilan PrintWindow dan merender gambar dalam konteks perangkat yang direferensikan oleh hdcBlt. Aplikasi menerima pesan WM_PRINT atau, jika bendera PW_PRINTCLIENT ditentukan, pesan WM_PRINTCLIENT . Untuk informasi selengkapnya, lihat WM_PRINT dan WM_PRINTCLIENT.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [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-2 (diperkenalkan dalam Windows 10, versi 10.0.10240)

Lihat juga

Melukis dan Menggambar Pesan

Gambaran Umum Melukis dan Menggambar

WM_PRINT

WM_PRINTCLIENT

Bagikan melalui