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

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

Criamos um objeto PrintSettings, atribuímos a orientação desejada e o passamos para Printer.Print() para impressão silenciosa ou para Printer.ShowPrintDialog() para impressão baseada 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 , a orientação é um booleano enterrado dentro de um que também requer tratamento de eventos, 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 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)

Os códigos PaperSize e PaperOrientation funcionam em conjunto — a configuração A4 na horizontal resulta em uma área de impressão de 297 × 210 mm, enquanto a configuração A4 na vertical resulta em 210 × 297 mm. A propriedade Dpi controla a resolução de saída (300 é o padrão para documentos comerciais), 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(), a caixa de 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/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 interface do usuário não bloqueantes, a variante assíncrona Printer.ShowPrintDialogAsync() aceita os mesmos parâmetros e mantém o aplicativo responsivo enquanto a caixa de diálogo estiver aberta. 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-o 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 a partir de $999.