PrintPreviewDialog — informacje o formancie (Windows Forms)

Formant Windows Forms PrintPreviewDialog jest wstępnie skonfigurowanym oknem dialogowym używanym do wyświetlania, w jaki sposób PrintDocument pojawi się po wydrukowaniu. Użyj go w aplikacji opartej na systemie Windows jako proste rozwiązanie zamiast konfigurować własne okno dialogowe. Kontrolka zawiera przyciski do drukowania, powiększania, wyświetlania jednej lub wielu stron i zamykania okna dialogowego.

Właściwości i metody klucza

Właściwość klucza kontrolki to Document , która ustawia dokument do podglądu. Dokument musi być PrintDocument obiektem. Aby wyświetlić okno dialogowe, należy wywołać jego ShowDialog metodę. Wygładzanie może sprawiać, że tekst wydaje się gładszy, ale może również spowodować spowolnienie wyświetlania. Aby go użyć, należy ustawić UseAntiAlias Właściwość na true .

Niektóre właściwości są dostępne za pomocą PrintPreviewControl PrintPreviewDialog . (Nie musisz dodawać tego PrintPreviewControl do formularza; jest on automatycznie zawarty w PrintPreviewDialog czasie dodawania okna dialogowego do formularza). Przykłady właściwości dostępnych w programie PrintPreviewControl to Columns Rows właściwości i, które określają liczbę stron wyświetlanych w poziomie i w pionie na formancie. Możesz uzyskać dostęp do Columns właściwości w PrintPreviewDialog1.PrintPreviewControl.Columns Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns w Visual C# lub printPreviewDialog1->PrintPreviewControl->Columns w Visual C++.

PrintPreviewDialog wydajność

W następujących warunkach PrintPreviewDialog formant jest zainicjowany bardzo wolno:

  • Używana jest drukarka sieciowa.
  • Preferencje użytkownika dotyczące tej drukarki, takie jak ustawienia dupleks, są modyfikowane.

W przypadku aplikacji uruchamianych w .NET Framework 4.5.2 można dodać następujący klucz do <appSettings> sekcji pliku konfiguracji, aby zwiększyć wydajność PrintPreviewDialog inicjowania kontroli:

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

Jeśli EnablePrintPreviewOptimization klucz jest ustawiony na inną wartość lub jeśli klucz nie istnieje, optymalizacja nie zostanie zastosowana.

W przypadku aplikacji uruchamianych w .NET Framework 4,6 lub nowszych wersjach można dodać następujący przełącznik do <AppContextSwitchOverrides> elementu w <runtime> sekcji pliku konfiguracyjnego aplikacji:

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

Jeśli przełącznik nie jest obecny lub jest ustawiony na inną wartość, optymalizacja nie zostanie zastosowana.

W przypadku użycia QueryPageSettings zdarzenia w celu zmodyfikowania ustawień drukarki wydajność PrintPreviewDialog kontrolki nie zostanie zwiększona nawet po ustawieniu przełącznika konfiguracji optymalizacji.

Zobacz także