PrintPreviewDialog denetimine genel bakış (Windows Forms)

  • Makale

Windows Forms PrintPreviewDialog denetimi, yazdırıldığında PrintDocument'ın nasıl görüneceğini 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 özelliğidir Document. Belge bir PrintDocument nesne olmalıdır. İletişim kutusunu görüntülemek için yöntemini çağırmanız ShowDialog gerekir. Diğer addan koruma, metnin daha düzgün görünmesini sağlayabilir, ancak aynı zamanda ekranı daha yavaş hale de getirir; kullanmak için özelliğini olarak trueayarlayınUseAntiAlias.

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

PrintPreviewDialog performansı

Aşağıdaki koşullar altında denetim PrintPreviewDialog çok 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.

.NET Framework 4.5.2 üzerinde çalışan uygulamalar için, denetim başlatma performansını PrintPreviewDialog geliştirmek için <yapılandırma dosyanızın uygulama Ayarlar> bölümüne aşağıdaki anahtarı ekleyebilirsiniz:

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

EnablePrintPreviewOptimization Anahtar başka bir değere ayarlanmışsa veya anahtar yoksa iyileştirme uygulanmaz. Uygulama .NET Framework 4.6 veya üzeri üzerinde çalışıyorsa bu anahtarın hiçbir etkisi yoktur.

.NET Framework 4.6 veya sonraki sürümlerinde çalışan uygulamalar için, uygulama yapılandırma dosyanızın çalışma zamanı> bölümündeki AppContextSwitchOverrides> öğesine< aşağıdaki anahtarı <ekleyebilirsiniz:

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

Anahtar yoksa veya başka bir değere ayarlanmışsa, iyileştirme uygulanmaz.

Yazıcı ayarlarını değiştirmek için olayını kullanırsanız QueryPageSettings , bir iyileştirme yapılandırma anahtarı ayarlansa bile denetimin PrintPreviewDialog performansı iyileşmez.

Ayrıca bkz.