Como Imprimir com um Diálogo em C

Entrada

O relatório trimestral.pdf passado para ShowPrintDialog, um sumário financeiro estilizado do Q3 corporativo com cartões de métrica KPI e tabelas de receita de divisão, representando um documento comercial típico enviado para o diálogo de impressão.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-show-print-dialog-open-and-print.cs

using IronPrint;

// Open the print dialog and print
Printer.ShowPrintDialog("quarterly-report.pdf");

Imports IronPrint

' Open the print dialog and print
Printer.ShowPrintDialog("quarterly-report.pdf")

Saída

Diálogo de impressão nativo aberto pelo ShowPrintDialog para o relatório trimestral.

O método aceita um caminho de arquivo como string ou dados de arquivo bruto como byte[]. IronPrint detecta o formato do documento, renderiza-o através do motor apropriado, e apresenta o diálogo. Quando o usuário confirma, o documento é impresso com as configurações escolhidas. O tutorial de impressão de documentos explora o ciclo completo de impressão em mais detalhes.

Entrada

O invoice.pdf pré-carregado com configurações de retrato A4 a 300 DPI: uma fatura profissional de cobrança com itens de linha, desconto, imposto e instruções de transferência bancária, mostrando um documento realista onde a aplicação já conhece o tamanho e a orientação de papel requeridos.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-preconfigure-dialog-settings.cs

using IronPrint;

// Pre-configure default dialog settings
var settings = new PrintSettings
{
    PrinterName = "HP LaserJet Pro",
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = false
};

// Open the dialog with pre-filled settings
Printer.ShowPrintDialog("invoice.pdf", settings);

Imports IronPrint

' Pre-configure default dialog settings
Dim settings As New PrintSettings With {
    .PrinterName = "HP LaserJet Pro",
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .Grayscale = False
}

' Open the dialog with pre-filled settings
Printer.ShowPrintDialog("invoice.pdf", settings)

Saída

Diálogo de impressão nativo aberto com configurações de retrato A4 pré-configuradas.

Isso é útil quando o aplicativo já conhece previamente a impressora ou o formato de papel provável. Por exemplo, um sistema de ponto de venda que sempre imprime recibos em uma impressora térmica específica pode definir o padrão PrinterName para esse dispositivo. O usuário ainda tem a opção de alterá-lo no diálogo.

Para descobrir quais impressoras estão disponíveis no sistema, chamamos Printer.GetPrinterNames(), que retorna um List<string> de todas as impressoras instaladas. De forma semelhante, Printer.GetPrinterTrays() retorna bandejas de papel disponíveis para uma impressora específica.

A lista completa de propriedades configuráveis inclui PrinterName, PaperSize, PaperOrientation, Dpi, NumberOfCopies, Grayscale, PaperMargins, Flatten (para campos de formulário PDF), e Tray. O guia de configurações de impressão cobre cada propriedade com exemplos de código. Qualquer propriedade não definida em PrintSettings por padrão vai para a configuração padrão da impressora selecionada.

Entrada

O report.pdf aguardado de forma assíncrona: um relatório de infraestrutura de TI e segurança de várias seções, representando o tipo de documento de longo formato onde a apresentação do diálogo não bloqueante mantém a interface de usuário responsiva enquanto o arquivo carrega.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-show-print-dialog-async.cs

using IronPrint;

// Open the print dialog asynchronously
await Printer.ShowPrintDialogAsync("report.pdf");

Imports IronPrint

' Open the print dialog asynchronously
Await Printer.ShowPrintDialogAsync("report.pdf")

Saída

Diálogo de impressão nativo aberto de forma assíncrona via ShowPrintDialogAsync, com o console confirmando a execução não bloqueante.

ShowPrintDialogAsync() aceita os mesmos parâmetros da versão síncrona: um caminho de arquivo ou matriz de bytes, além de um objeto opcional PrintSettings. O padrão assíncrono segue o mesmo Padrão Assíncrono Baseado em Tarefas usado em todo o desenvolvimento moderno do .NET.

IronPrint funciona em aplicativos WinForms, WPF, MAUI e console. A aparência do diálogo se adapta à plataforma host e à versão do sistema operacional, para que o usuário sempre veja a janela de impressão nativa que espera.

Entrada

relatório-mensal.pdf lido em um byte[], representando um documento recuperado de um banco de dados ou gerado na memória antes de ser enviado para o diálogo.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-print-dialog-image-and-byte-array.cs

using IronPrint;

// Print an image with the dialog
Printer.ShowPrintDialog("product-photo.png");

// Print from a byte array
byte[] reportData = File.ReadAllBytes("monthly-report.pdf");
Printer.ShowPrintDialog(reportData);

Imports IronPrint

' Print an image with the dialog
Printer.ShowPrintDialog("product-photo.png")

' Print from a byte array
Dim reportData As Byte() = File.ReadAllBytes("monthly-report.pdf")
Printer.ShowPrintDialog(reportData)

Saída

O diálogo abre conforme visto nos exemplos acima. A detecção de formato é automática: seja passando um caminho de arquivo ou um byte[], o IronPrint renderiza o documento e apresenta o mesmo diálogo nativo.

A página de exemplos de código mostra cenários adicionais específicos para formatos. Para fluxos de trabalho específicos de PDF (gerar um PDF e imprimi-lo imediatamente), IronPDF combina naturalmente com o IronPrint.