1. IronPrint
  2. Tutoriais
  3. Definir orientação do papel

Como Definir a Orientação do Papel para Impressão em C#

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

O controle de orientação do papel determina se um documento é impresso no modo retrato (alto) ou paisagem (largo). O modo retrato funciona para a maioria das cartas, faturas e relatórios. O modo paisagem é a melhor escolha para tabelas largas, planilhas, painéis e slides de apresentação. Definir a orientação programaticamente garante uma saída consistente, independentemente da configuração padrão da impressora do usuário.

IronPrint expõe uma propriedade PaperOrientation na classe PrintSettings. Nós o configuramos para Portrait ou Landscape, passamos as configurações para Printer.Print(), e o documento é impresso no layout especificado.

Início Rápido: Definir Orientação do Papel

  1. Instale o IronPrint via NuGet: Install-Package IronPrint
  2. Adicione using IronPrint; ao arquivo
  3. Crie um objeto PrintSettings
  4. Defina PaperOrientation como Portrait ou Landscape
  5. Passe as configurações para Printer.Print() ou Printer.ShowPrintDialog()

  1. Instale IronPrint com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPrint

  2. Copie e execute este trecho de código.

    using IronPrint;

// Print a document in landscape orientation
Printer.Print("report.pdf", new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape
});

  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronPrint em seu projeto hoje com uma avaliação gratuita

    arrow pointer
### Fluxo de trabalho mínimo (5 etapas)
  1. Instale a biblioteca de impressão IronPrint C#
  2. Crie um objeto `PrintSettings`
  3. Defina `PaperOrientation` para `Portrait` ou `Landscape`
  4. Passe as configurações para `Printer.Print()`
  5. Execute o projeto para imprimir com a orientação especificada

Como Defino a Orientação do Papel para Impressão?

A propriedade PaperOrientation em PrintSettings aceita três valores:

  • PaperOrientation.Portrait — layout vertical (padrão na maioria das impressoras). Melhor para documentos de uma coluna, como cartas, contratos e faturas.
  • PaperOrientation.Landscape — layout horizontal. Melhor para conteúdo largo, como tabelas de dados, gráficos de Gantt, planilhas e apresentações de slides.
  • PaperOrientation.Automatic — deixa para a configuração padrão da impressora.

Criamos um objeto PrintSettings, atribuimos a orientação desejada, e o passamos para Printer.Print() para impressão silenciosa ou Printer.ShowPrintDialog() para impressão com diálogo.

:path=/static-assets/print/content-code-examples/how-to/set-paper-orientation/portrait-and-landscape-orientation.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

Com a abordagem nativa do .NET System.Drawing.Printing, a orientação é um booleano (DefaultPageSettings.Landscape = true) incrustado dentro de um PrintDocument que também requer manipulação de eventos PrintPage, renderização gráfica e gerenciamento manual de páginas. IronPrint substitui todo esse pipeline com uma única propriedade em um objeto de configurações.

Como Combino Orientação com Outras Configurações de Impressão?

A orientação é mais útil quando combinada com tamanho de papel, DPI e margens para definir um layout de impressão completo. A classe PrintSettings nos permite configurar tudo isso em um único objeto.

:path=/static-assets/print/content-code-examples/how-to/set-paper-orientation/combine-orientation-with-settings.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

PaperSize e PaperOrientation trabalham juntos — definir paisagem A4 resulta em uma área de impressão de 297 × 210 mm, enquanto retrato A4 resulta em 210 × 297 mm. A propriedade Dpi controla a resolução de saída (300 é o padrão para documentos empresariais), e os valores de PaperMargins estão em milímetros.

Como Permito que Usuários Escolham a Orientação no Diálogo de Impressão?

Quando passamos PrintSettings para Printer.ShowPrintDialog(), o diálogo abre com nossa orientação predefinida. O usuário pode aceitá-la ou alternar entre retrato e paisagem antes de imprimir.

:path=/static-assets/print/content-code-examples/how-to/set-paper-orientation/dialog-with-orientation-preset.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

Para cenários de UI sem bloqueio, a variante assíncrona Printer.ShowPrintDialogAsync() aceita os mesmos parâmetros e mantém o aplicativo responsivo enquanto o diálogo está aberto. Isso é especialmente útil para orientação porque os usuários muitas vezes querem visualizar como um documento parece em retrato versus paisagem antes de se comprometer com uma impressão. O tutorial de documento de impressão cobre tanto fluxos de trabalho silenciosos quanto com diálogo de ponta a ponta.

Próximos passos

A orientação do papel é uma propriedade do objeto PrintSettings — defina PaperOrientation como Portrait, Landscape, ou Automatic e passe-a para qualquer método de impressão do IronPrint. Combine-o com PaperSize, Dpi, e PaperMargins para controle total do layout.

Explore as configurações de impressão como fazer para cada propriedade disponível, a referência da API da classe Printer para o método completo e a página de exemplos de código para snippets prontos para executar. Os tutoriais do IronPrint percorrem todo o ciclo de vida de impressão, e o changelog acompanha as atualizações recentes, incluindo melhorias de desempenho.

Inicie um teste gratuito de 30 dias para testar configurações de orientação em um projeto ao vivo. Quando estiver pronto, veja as opções de licenciamento começando em $749.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 38,093 | Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPrint
executar um exemplo Veja seu documento chegar à impressora.