Visão geral do controle PrintPreviewDialog (Windows Forms)

  • Artigo

O controle Windows Forms PrintPreviewDialog é uma caixa de diálogo pré-configurada usada para exibir como um PrintDocument aparecerá quando impresso. Use-o em seu aplicativo baseado no Windows como uma solução simples em vez de configurar sua própria caixa de diálogo. O controle contém botões para imprimir, aumentar o zoom, exibir uma ou várias páginas e fechar a caixa de diálogo.

Principais propriedades e métodos

A propriedade key do controle é Document, que define o documento a ser visualizado. O documento deve ser um PrintDocument objeto. Para exibir a caixa de diálogo, você deve chamar seu ShowDialog método. A suavização de borda pode fazer com que o texto pareça mais suave, mas também pode tornar a exibição mais lenta; Para usá-lo, defina a UseAntiAlias propriedade como true.

Certas propriedades estão disponíveis através do PrintPreviewControl que o PrintPreviewDialog contém. (Você não precisa adicioná-lo PrintPreviewControl ao formulário; ele está automaticamente contido no PrintPreviewDialog quando você adiciona a caixa de diálogo ao formulário.) Exemplos de propriedades disponíveis por meio do PrintPreviewControl são as Columns propriedades e , que determinam o número de páginas exibidas horizontal e Rows verticalmente no controle. Você pode acessar a Columns propriedade como PrintPreviewDialog1.PrintPreviewControl.Columns no Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns no Visual C# ou printPreviewDialog1->PrintPreviewControl->Columns no Visual C++.

Desempenho de PrintPreviewDialog

Sob as seguintes condições, o PrintPreviewDialog controle inicializa muito lentamente:

  • Uma impressora de rede é usada.
  • As preferências do usuário para esta impressora, como configurações duplex, são modificadas.

Para aplicativos em execução no .NET Framework 4.5.2, você pode adicionar a <seguinte chave à seção appSettings> do arquivo de configuração para melhorar o desempenho da inicialização do PrintPreviewDialog controle:

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

Se a chave estiver definida como qualquer outro valor ou se a chave não estiver presente, a EnablePrintPreviewOptimization otimização não será aplicada. Essa chave não terá efeito se o aplicativo estiver sendo executado no .NET Framework 4.6 ou posterior.

Para aplicativos em execução no .NET Framework 4.6 ou versões posteriores, você pode adicionar a seguinte opção ao <elemento AppContextSwitchOverrides> na< seção de tempo de execução> do arquivo de configuração do aplicativo:

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

Se a opção não estiver presente ou se estiver definida como qualquer outro valor, a otimização não será aplicada.

Se você usar o evento para modificar as QueryPageSettings configurações da impressora, o PrintPreviewDialog desempenho do controle não melhorará mesmo se uma opção de configuração de otimização estiver definida.

Confira também