Aracılığıyla paylaş

PrintPreviewDialog denetimine genel bakış (Windows Forms)

Windows Forms PrintPreviewDialog denetimi, yazdırıldığında PrintDocument'ın nasıl göründüğünü görüntülemek için kullanılan önceden yapılandırılmış bir iletişim kutusudur. Kendi iletişim kutunuzu yapılandırmak yerine windows tabanlı uygulamanızda basit bir çözüm olarak kullanın. Denetimde yazdırma, yakınlaştırma, bir veya birden çok sayfa görüntüleme ve iletişim kutusunu kapatma düğmeleri bulunur.

Temel özellikler ve yöntemler

Denetimin anahtar özelliği, belgeyi önizlemeye ayarlayan Document' dir. Belge bir PrintDocument nesnesi olmalıdır. İletişim kutusunu görüntülemek için ShowDialog yöntemini çağırmanız gerekir. Kenar yumuşatma, metnin daha düzgün görünmesini sağlayabilir, ancak ekranı da daha yavaşlatabilir; kullanmak için UseAntiAlias özelliğini trueolarak ayarlayın.

PrintPreviewControl'in içerdiği PrintPreviewDialog aracılığıyla belirli özellikler kullanılabilir. (Formunuza PrintPreviewControl eklemeniz gerekmez; PrintPreviewDialog iletişim kutusunu formunuza eklediğinizde otomatik olarak içinde yer alır.) PrintPreviewControl aracılığıyla kullanılabilen özelliklere, denetimde yatay ve dikey olarak görüntülenen sayfa sayısını belirleyen Columns ve Rows özellikleri örnek verilebilir. Columns özelliğine Visual Basic'te PrintPreviewDialog1.PrintPreviewControl.Columns, Visual C# printPreviewDialog1.PrintPreviewControl.Columns veya Visual C++'da printPreviewDialog1->PrintPreviewControl->Columns olarak erişebilirsiniz.

PrintPreviewDialog performansı

Aşağıdaki koşullar altında denetim PrintPreviewDialog yavaş başlatılır:

  • Bir ağ yazıcısı kullanılır.
  • Bu yazıcı için çift yönlü ayarlar gibi kullanıcı tercihleri değiştirilir.

Sayfa ayarlarını değiştirmek için olayı kullanırsanız QueryPageSettings iyileştirme uygulanmaz.

İyileştirmeyi uygulamak için çalışma zamanı yapılandırma seçeneğini olarak Switch.System.Drawing.Printing.OptimizePrintPreviewayarlayıntrue.

Seçenek ,runtimeconfig.json yapılandırma dosyasında veya bir uygulamanın proje dosyasında ayarlanabilir:

  • Proje dosyasında varsayılan yapılandırma.

    Bu ayarı proje dosyasında uygulamak için, <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles> ve <PropertyGroup> içinde ayarlayarak çalışma zamanı yapılandırması oluşturmayı etkinleştirin. Ardından, <RuntimeHostConfigurationOption> ayarını <ItemGroup> öğesine ekleyin.

    <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>

  • runtimeconfig.template.json kaynak dosyasında varsayılanı yapılandırın.

    Uygulamanızın varsayılan ayarını yapılandırmak için ,runtimeconfig.template.json kaynak dosyasındaki ayarı uygulayın. Uygulama derlendiğinde veya yayımlandığında, şablon dosyası bir çalışma zamanı yapılandırma dosyası oluşturmak için kullanılır.

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

    Çalışma zamanı yapılandırması hakkında daha fazla bilgi için bkz. .NET çalışma zamanı yapılandırma ayarları.

  • Yayımlanan bir uygulamayı {appname}.runtimeconfig.json çıktı dosyasıyla yapılandırın.

    Yayımlanan uygulamayı yapılandırmak için {appname}.runtimeconfig.json dosyasının runtimeOptions/configProperties bölümündeki ayarı uygulayın.

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

    Çalışma zamanı yapılandırması hakkında daha fazla bilgi için bkz. .NET çalışma zamanı yapılandırma ayarları.

Ayrıca bakınız

  • Last updated on