Bagikan melalui

Gambaran umum kontrol PrintPreviewDialog (Formulir Windows)

  • Artikel

Kontrol Formulir Windows PrintPreviewDialog adalah kotak dialog yang telah dikonfigurasi sebelumnya yang digunakan untuk menampilkan bagaimana PrintDocument akan muncul saat dicetak. Gunakan dalam aplikasi berbasis Windows Anda sebagai solusi sederhana alih-alih mengonfigurasi kotak dialog Anda sendiri. Kontrol berisi tombol untuk mencetak, memperbesar tampilan, menampilkan satu atau beberapa halaman, dan menutup kotak dialog.

Properti dan metode utama

Properti kunci kontrol adalah Document, yang mengatur dokumen yang akan dipratinjau. Dokumen harus berupa PrintDocument objek. Untuk menampilkan kotak dialog, Anda harus memanggil metodenya ShowDialog . Anti-alias dapat membuat teks tampak lebih halus, tetapi juga dapat membuat tampilan lebih lambat; untuk menggunakannya, atur properti ke UseAntiAliastrue.

Properti tertentu tersedia melalui PrintPreviewControl yang berisi PrintPreviewDialog . (Anda tidak perlu menambahkan ini PrintPreviewControl ke formulir; secara otomatis terkandung dalam PrintPreviewDialog saat Anda menambahkan dialog ke formulir Anda.) Contoh properti yang tersedia melalui PrintPreviewControl adalah Columns properti dan Rows , yang menentukan jumlah halaman yang ditampilkan secara horizontal dan vertikal pada kontrol. Anda dapat mengakses Columns properti seperti PrintPreviewDialog1.PrintPreviewControl.Columns di Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns di Visual C#, atau printPreviewDialog1->PrintPreviewControl->Columns di Visual C++.

Performa PrintPreviewDialog

Dalam kondisi berikut, PrintPreviewDialog kontrol menginisialisasi dengan sangat lambat:

  • Pencetak jaringan digunakan.
  • Preferensi pengguna untuk printer ini, seperti pengaturan dupleks, dimodifikasi.

Untuk aplikasi yang berjalan di .NET Framework 4.5.2, Anda dapat menambahkan kunci berikut ke <bagian aplikasi Pengaturan> file konfigurasi Anda untuk meningkatkan performa PrintPreviewDialog inisialisasi kontrol:

<appSettings>
   <add key="EnablePrintPreviewOptimization" value="true" />
</appSettings>

Jika kunci EnablePrintPreviewOptimization diatur ke nilai lain, atau jika kunci tidak ada, pengoptimalan tidak diterapkan. Kunci ini tidak berpengaruh jika aplikasi berjalan pada .NET Framework 4.6 atau yang lebih baru.

Untuk aplikasi yang berjalan pada .NET Framework 4.6 atau versi yang lebih baru, Anda dapat menambahkan sakelar berikut ke <elemen AppContextSwitchOverrides> di< bagian runtime> file konfigurasi aplikasi Anda:

<runtime >
   <!-- AppContextSwitchOverrides values are in the form of 'key1=true|false;key2=true|false -->
   <AppContextSwitchOverrides value = "Switch.System.Drawing.Printing.OptimizePrintPreview=true" />
</runtime >

Jika sakelar tidak ada atau jika diatur ke nilai lain, pengoptimalan tidak diterapkan.

Jika Anda menggunakan QueryPageSettings kejadian untuk mengubah pengaturan printer, performa PrintPreviewDialog kontrol tidak akan meningkat meskipun sakelar konfigurasi pengoptimalan diatur.

Baca juga