Sdílet prostřednictvím

Přehled ovládacího prvku PrintPreviewDialog (Windows Forms)

  • Článek

Ovládací prvek Windows Forms PrintPreviewDialog je předem nakonfigurované dialogové okno, které slouží k zobrazení toho, jak se při tisku zobrazí PrintDocument. Použijte ji v rámci aplikace založené na Systému Windows jako jednoduché řešení místo konfigurace vlastního dialogového okna. Ovládací prvek obsahuje tlačítka pro tisk, přiblížení, zobrazení jedné nebo více stránek a zavření dialogového okna.

Klíčové vlastnosti a metody

Klíčová vlastnost ovládacího prvku je Document, která určuje dokument k náhledu. Dokument musí být objektem PrintDocument. Chcete-li zobrazit dialogové okno, musíte zavolat jeho metodu ShowDialog. Anti-aliasing může usnadnit zobrazení textu, ale může také zpomalit zobrazení; chcete-li jej použít, nastavte vlastnost UseAntiAlias na true.

Některé vlastnosti jsou k dispozici prostřednictvím PrintPreviewControl, které PrintPreviewDialog obsahuje. (Tento PrintPreviewControl nemusíte do formuláře přidávat. Při přidávání dialogového okna do formuláře se automaticky nachází v PrintPreviewDialog.) Příklady vlastností dostupných prostřednictvím PrintPreviewControl jsou vlastnosti Columns a Rows, které určují počet stránek zobrazených vodorovně a svisle v ovládacím prvku. K vlastnosti Columns můžete přistupovat jako PrintPreviewDialog1.PrintPreviewControl.Columns v jazyce Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns v jazyce Visual C# nebo printPreviewDialog1->PrintPreviewControl->Columns v jazyce Visual C++.

Výkon PrintPreviewDialog

Za následujících podmínek se ovládací prvek PrintPreviewDialog inicializuje velmi pomalu:

  • Používá se síťová tiskárna.
  • Uživatelské předvolby pro tuto tiskárnu, například duplexní nastavení, jsou změněny.

Pro aplikace spuštěné v rozhraní .NET Framework 4.5.2 můžete do oddílu <appSettings> konfiguračního souboru přidat následující klíč, aby se zlepšil výkon inicializace ovládacích prvků PrintPreviewDialog:

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

Pokud je klíč EnablePrintPreviewOptimization nastaven na jinou hodnotu nebo pokud klíč neexistuje, optimalizace se nepoužije. Tento klíč nemá žádný vliv, pokud aplikace běží na rozhraní .NET Framework 4.6 nebo novější.

U aplikací spuštěných v rozhraní .NET Framework 4.6 nebo novějších verzích můžete přidat následující přepínač do elementu <AppContextSwitchOverrides> v části <runtime> konfiguračního souboru aplikace.

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

Pokud přepínač neexistuje nebo je nastaven na jinou hodnotu, optimalizace se nepoužije.

Pokud k úpravě nastavení tiskárny použijete událost QueryPageSettings, výkon ovládacího prvku PrintPreviewDialog se nezlepší ani v případě, že je nastavený přepínač konfigurace optimalizace.

Viz také