Como Imprimir com um Diálogo em C

Entrada

O arquivo quarterly-report.pdf, enviado para ShowPrintDialog, é um resumo financeiro corporativo formatado do terceiro trimestre, com cartões de métricas de KPIs e tabelas de receita por divisão, representando um documento comercial típico enviado para a caixa de 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 um string ou dados brutos de arquivo como um 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 PrinterName como padrão para esse dispositivo. O usuário ainda terá a opção de alterá-lo na caixa de 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. Da mesma forma, Printer.GetPrinterTrays() retorna as bandejas de papel disponíveis para uma determinada impressora.

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 assume por padrão 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 que a versão síncrona: um caminho de arquivo ou matriz de bytes, Plus 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

monthly-report.pdf lido em um byte[], representando um documento recuperado de um banco de dados ou gerado na memória antes de ser enviado para a caixa de 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: quer passemos um caminho de arquivo ou um byte[], o IronPrint renderiza o documento e apresenta a mesma caixa de diálogo nativa.

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.