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

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

The PaperOrientation property on PrintSettings accepts three values:

• 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 — depende da configuração padrão da impressora.

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

:path=/static-assets/print/content-code-examples/how-to/set-paper-orientation/set-paper-orientation-portrait-and-landscape-orientation.cs

using IronPrint;

// Configure portrait orientation
var portraitSettings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Portrait
};

// Print the invoice in portrait
Printer.Print("invoice.pdf", portraitSettings);

// Configure landscape orientation
var landscapeSettings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape
};

// Print the dashboard in landscape
Printer.Print("quarterly-dashboard.pdf", landscapeSettings);

Imports IronPrint

' Configure portrait orientation
Dim portraitSettings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Portrait
}

' Print the invoice in portrait
Printer.Print("invoice.pdf", portraitSettings)

' Configure landscape orientation
Dim landscapeSettings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape
}

' Print the dashboard in landscape
Printer.Print("quarterly-dashboard.pdf", landscapeSettings)

Com a abordagem nativa do .NET System.Drawing.Printing, a orientação é um booleano (DefaultPageSettings.Landscape = true) oculto 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/set-paper-orientation-combine-orientation-with-settings.cs

using IronPrint;

// Combine orientation with paper size, DPI, and margins
var settings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape,
    PaperSize = PaperSize.A4,
    Dpi = 300,
    NumberOfCopies = 1,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print the financial report
Printer.Print("financial-report.pdf", settings);

Imports IronPrint

' Combine orientation with paper size, DPI, and margins
Dim settings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape,
    .PaperSize = PaperSize.A4,
    .Dpi = 300,
    .NumberOfCopies = 1,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

' Print the financial report
Printer.Print("financial-report.pdf", settings)

PaperSize e PaperOrientation trabalham juntos — definir A4 paisagem proporciona uma área de impressão de 297 × 210 mm, enquanto A4 retrato dá 210 × 297 mm. A propriedade Dpi controla a resolução de saída (300 é padrão para documentos comerciais), e os valores 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 é aberto 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/set-paper-orientation-dialog-with-orientation-preset.cs

using IronPrint;

// Pre-configure landscape orientation for the dialog
var settings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape,
    PaperSize = PaperSize.Letter
};

// Open the dialog with pre-selected orientation
Printer.ShowPrintDialog("wide-report.pdf", settings);

Imports IronPrint

' Pre-configure landscape orientation for the dialog
Dim settings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape,
    .PaperSize = PaperSize.Letter
}

' Open the dialog with pre-selected orientation
Printer.ShowPrintDialog("wide-report.pdf", settings)

Para cenários de UI não bloqueantes, a variante assíncrona Printer.ShowPrintDialogAsync() aceita os mesmos parâmetros e mantém a aplicação responsiva 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 no objeto PrintSettings — defina PaperOrientation para Portrait, Landscape, ou Automatic e passe para qualquer método de impressão do IronPrint. Combine 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 $999.