Compartilhar via

Visão geral do controle PrintPreviewDialog (Windows Forms)

O controle dos Windows Forms PrintPreviewDialog é uma caixa de diálogo pré-configurada usada para exibir como um PrintDocument aparece 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, ampliar, exibir uma ou várias páginas e fechar a caixa de diálogo.

Principais propriedades e métodos

A propriedade de chave 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. O anti-aliasing pode fazer com que o texto pareça mais suave, mas também pode tornar a exibição mais lenta; para usá-la, defina a UseAntiAlias propriedade como true.

Determinadas propriedades estão disponíveis por meio de PrintPreviewControl que PrintPreviewDialog contém. (Você não precisa adicionar PrintPreviewControl ao formulário; ele é automaticamente contido no PrintPreviewDialog momento em que você adiciona a caixa de diálogo ao seu formulário.) Exemplos de propriedades disponíveis por meio do PrintPreviewControl são as Columns propriedades e Rows , que determinam o número de páginas exibidas horizontal e 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 do PrintPreviewDialog

Nas seguintes condições, o PrintPreviewDialog controle inicializa lentamente:

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

A otimização não será aplicada se você usar o QueryPageSettings evento para modificar as configurações de página.

Para aplicar a otimização, defina a opção Switch.System.Drawing.Printing.OptimizePrintPreview de configuração de runtime como true.

A opção pode ser definida no arquivo de configuração runtimeconfig.json ou no arquivo de projeto de um aplicativo:

  • Configure um padrão no arquivo de projeto.

    Para aplicar a configuração no arquivo de projeto, habilite a geração de configuração de runtime definindo <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles> em um <PropertyGroup>. Em seguida, adicione a <RuntimeHostConfigurationOption> configuração a um <ItemGroup>:

    <Project Sdk="Microsoft.NET.Sdk">

  <!-- Other project settings ... -->

  <PropertyGroup>
    <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>
  </PropertyGroup>

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="Switch.System.Drawing.Printing.OptimizePrintPreview" Value="true" />
  </ItemGroup>

</Project>

  • Configure um padrão no arquivo de origem runtimeconfig.template.json .

    Para definir a configuração padrão do aplicativo, aplique a configuração no arquivo de origem runtimeconfig.template.json . Quando o aplicativo é compilado ou publicado, o arquivo de modelo é usado para gerar um arquivo de configuração de runtime.

    {
  "configProperties": {
    "Switch.System.Drawing.Printing.OptimizePrintPreview": true
  }
}

    Para obter mais informações sobre a configuração de runtime, consulte as configurações de runtime do .NET.

  • Configure um aplicativo publicado com o arquivo de saída {appname}.runtimeconfig.json .

    Para configurar o aplicativo publicado, aplique a configuração no arquivo {appname}.runtimeconfig.json na seção runtimeOptions/configProperties.

    {
  "runtimeOptions": {
    "configProperties": {
      "Switch.System.Drawing.Printing.OptimizePrintPreview": true,
    }
  }
}

    Para obter mais informações sobre a configuração de runtime, consulte as configurações de runtime do .NET.

Consulte também

  • Last updated on