Como Definir o Tamanho do Papel para Impressão em C

Como Defino o Tamanho do Papel ao Imprimir em C#?

Definimos o tamanho do papel atribuindo um valor da enumeração PaperSize à propriedade PaperSize em um objeto PrintSettings . Em seguida, passamos esse objeto para qualquer um dos métodos de impressão do IronPrint.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-set-paper-size.cs

using IronPrint;

// Configure print settings with US Letter paper
PrintSettings settings = new PrintSettings();
settings.PaperSize = PaperSize.Letter;

// Print to the default printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with US Letter paper
Dim settings As New PrintSettings()
settings.PaperSize = PaperSize.Letter

' Print to the default printer
Printer.Print("invoice.pdf", settings)

Primeiro, instanciamos PrintSettings, que é inicializado com os valores padrão da impressora. Em seguida, substituímos PaperSize por PaperSize.Letter, que corresponde ao formato padrão de 8,5 × 11 polegadas. Quando chamamos Printer.Print, o IronPrint envia o documento para a impressora padrão do sistema usando esse tamanho de papel.

Se nenhum PaperSize for especificado, o IronPrint usa PaperSize.PrinterDefault, que se baseia no tamanho de papel configurado na impressora padrão do sistema operacional. Este é um detalhe essencial para ambientes de produção onde as configurações das impressoras variam entre as máquinas.

Quais Tamanhos de Papel a Biblioteca Suporta?

A enumeração PaperSize inclui doze valores que abrangem padrões internacionais ISO, tamanhos comuns dos EUA e o padrão da impressora. A tabela abaixo lista todas as opções disponíveis.

Cada valor mapeia diretamente para um padrão de papel bem conhecido. A opção PrinterDefault instrui o IronPrint a usar o tamanho para o qual a impressora está configurada no momento — útil quando se deseja respeitar as preferências de impressão do usuário final, em vez de impor um formato específico.

Para uma referência completa da API, consulte a documentação da classe PaperSize.

Como combinar o tamanho do papel com outras configurações de impressão?

A classe PrintSettings expõe várias propriedades além de PaperSize. Podemos configurar orientação, DPI, margens, contagem de cópias e modo em escala de cinza — tudo em um único objeto.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-combined-settings.cs

using IronPrint;

// Configure full print settings
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

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

Imports IronPrint

' Configure full print settings
Dim settings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 300,
    .NumberOfCopies = 3,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

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

Usamos a sintaxe de inicializador de objeto aqui para clareza. Orientation gira a folha A4 em relação ao seu eixo mais largo. DPI em 300 garante uma saída nítida para gráficos e textos pequenos. Margins aceita quatro valores em milímetros — superior, direito, inferior, esquerdo — através do construtor Margins. A propriedade CopyCount tem como valor padrão 1, mas a definimos explicitamente para facilitar a leitura.

Essas propriedades funcionam juntas sem conflito. O IronPrint valida a configuração e passa as configurações combinadas para o driver da impressora como um único trabalho de impressão. Para configurações mais avançadas, como seleção de impressora e configuração de bandeja, consulte o guia completo de configurações de impressão.

Como imprimir de forma assíncrona com um tamanho de papel personalizado?

Para aplicações onde bloquear a thread principal não é uma opção — como aplicativos WPF ou WinForms — usamos Printer.PrintAsync. O método aceita o mesmo objeto PrintSettings e retorna um Task.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-async-print.cs

using IronPrint;
using System.Threading.Tasks;

public class DocumentPrinter
{
    public async Task PrintLegalDocumentAsync(string filePath)
    {
        // Configure Legal paper size
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print asynchronously
        await Printer.PrintAsync(filePath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class DocumentPrinter
    Public Async Function PrintLegalDocumentAsync(filePath As String) As Task
        ' Configure Legal paper size
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

Este exemplo baseado em classes demonstra um padrão realista onde um serviço DocumentPrinter encapsula a lógica de impressão. Configuramos PaperSize.Legal (8,5 × 14 polegadas), que é o formato padrão para contratos e documentos legais. A palavra-chave await garante que a thread de chamada permaneça responsiva enquanto o IronPrint processa o trabalho de impressão.

Podemos chamar este método a partir de um manipulador de clique de botão, um serviço em segundo plano ou em qualquer lugar onde await seja suportado. Os métodos assíncronos do IronPrint — incluindo PrintAsync e ShowPrintDialogAsync — aceitam a mesma configuração PrintSettings, portanto, o comportamento do tamanho do papel é idêntico entre os caminhos síncronos e assíncronos.

Quais são os meus próximos passos?

Abordamos como definir o tamanho do papel em C# usando o enum PaperSize do IronPrint, desde a configuração básica de uma única propriedade até configurações combinadas e impressão assíncrona. A classe PrintSettings fornece uma API limpa e fortemente tipada que elimina as suposições em relação às dimensões do papel.

Para continuar explorando as capacidades do IronPrint:

• Saiba como configurar todas as configurações de impressão incluindo nome da impressora, bandeja e escala de cinza
• Veja exemplos de código de configurações de impressão para cenários comuns
• Consulte a referência completa da API para classes como Printer, PrintSettings, PaperSize

Inicie um teste gratuito de 30 dias para testar a configuração do tamanho do papel em seus próprios projetos, ou veja opções de licenciamento para implantação em produção.

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false