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

  • Článek

Ovládací prvek model Windows Forms PrintPreviewDialog je předkonfigurované 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á nastaví dokument na náhled. Dokument musí být PrintDocument objekt. Chcete-li zobrazit dialogové okno, musíte volat jeho ShowDialog metodu. Anti-aliasing může usnadnit zobrazení textu, ale může také zpomalit zobrazení; chcete-li jej použít, nastavte UseAntiAlias vlastnost na true.

Některé vlastnosti jsou k dispozici prostřednictvím PrintPreviewControl toho PrintPreviewDialog , co obsahuje. (Nemusíte ho PrintPreviewControl přidávat do formuláře; je automaticky obsažen v PrintPreviewDialog dialogovém okně do formuláře.) Mezi dostupné PrintPreviewControlColumns vlastnosti patří vlastnosti a Rows vlastnosti, které určují počet stránek zobrazených vodorovně a svisle v ovládacím prvku. K vlastnosti můžete přistupovat Columns 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 PrintPreviewDialog ovládací prvek 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 <aplikace přidat následující klíč Nastavení> oddíl konfiguračního souboru, abyste zlepšili výkon PrintPreviewDialog inicializace řízení:

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

EnablePrintPreviewOptimization Pokud je klíč 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ší.

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

<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 QueryPageSettings událost, výkon PrintPreviewDialog ovládacího prvku se nezlepší ani v případě, že je nastavený přepínač konfigurace optimalizace.

Viz také