Bagikan melalui

Gambaran umum kontrol PrintPreviewDialog (Windows Forms)

Kontrol Windows Forms PrintPreviewDialog adalah kotak dialog yang telah dikonfigurasi sebelumnya yang digunakan untuk menampilkan bagaimana PrintDocument 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 utama kontrol adalah Document, yang menentukan dokumen untuk dipratinjau. Dokumen harus berupa objek PrintDocument. Untuk menampilkan kotak dialog, Anda harus memanggil metode ShowDialog. Anti-alias dapat membuat teks tampak lebih halus, tetapi juga dapat membuat tampilan lebih lambat; untuk menggunakannya, atur properti UseAntiAlias ke true.

Properti tertentu tersedia melalui PrintPreviewControl yang dimiliki oleh PrintPreviewDialog. (Anda tidak perlu menambahkan 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 properti Columns sebagai PrintPreviewDialog1.PrintPreviewControl.Columns di Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns di Visual C#, atau printPreviewDialog1->PrintPreviewControl->Columns di Visual C++.

Performa PrintPreviewDialog

Dalam kondisi berikut, kontrol PrintPreviewDialog akan menginisialisasi dengan lambat:

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

Pengoptimalan tidak diterapkan jika Anda menggunakan QueryPageSettings peristiwa untuk mengubah pengaturan halaman.

Untuk menerapkan pengoptimalan, atur Switch.System.Drawing.Printing.OptimizePrintPreview opsi konfigurasi runtime ke true.

Opsi dapat diatur dalam file konfigurasi runtimeconfig.json atau file proyek aplikasi:

  • Mengonfigurasi default dalam file proyek.

    Untuk menerapkan pengaturan dalam file proyek, aktifkan pembuatan konfigurasi runtime dengan mengatur <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles> ke dalam <PropertyGroup>. Kemudian, tambahkan pengaturan <RuntimeHostConfigurationOption> ke <ItemGroup>:

    <Project Sdk="Microsoft.NET.Sdk">

  <!-- Other project settings ... -->

  <PropertyGroup>
    <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>
  </PropertyGroup>

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="Switch.System.Drawing.Printing.OptimizePrintPreview" Value="true" />
  </ItemGroup>

</Project>

  • Konfigurasikan default dalam file sumber runtimeconfig.template.json .

    Untuk mengonfigurasi pengaturan default untuk aplikasi Anda, terapkan pengaturan di file sumber runtimeconfig.template.json . Saat aplikasi dikompilasi atau diterbitkan, file templat digunakan untuk menghasilkan file konfigurasi runtime.

    {
  "configProperties": {
    "Switch.System.Drawing.Printing.OptimizePrintPreview": true
  }
}

    Untuk informasi selengkapnya tentang konfigurasi runtime, lihat Pengaturan konfigurasi runtime .NET.

  • Konfigurasikan aplikasi yang diterbitkan dengan file output {appname}.runtimeconfig.json .

    Untuk mengonfigurasi aplikasi yang diterbitkan, terapkan pengaturan di bagian {appname}.runtimeconfig.json file runtimeOptions/configProperties .

    {
  "runtimeOptions": {
    "configProperties": {
      "Switch.System.Drawing.Printing.OptimizePrintPreview": true,
    }
  }
}

    Untuk informasi selengkapnya tentang konfigurasi runtime, lihat Pengaturan konfigurasi runtime .NET.

Lihat juga

  • Last updated on