Como imprimir um arquivo em uma impressora usando C#

Instalar o Visual Studio

Se você não tem o Visual Studio instalado, baixe e instale-o do site oficial: Visual Studio.

Criar um novo projeto

1. Abra o Visual Studio.
2. Clique em "Criar um novo projeto".

Escolher Modelo de Projeto

1. No diálogo "Criar um novo projeto", selecione "Windows Forms App (.NET Framework)" ou "Windows Forms App (.NET Core)" baseado na sua preferência.

2. Forneça um nome e uma localização para seu projeto.

3. Clique em Avançar e, na tela de informações adicionais, selecione o .NET Framework e clique em "Criar".

Desenhar o Formulário

1. Uma vez criado o projeto, o formulário principal será exibido no designer.
2. Use a caixa de ferramentas para adicionar controles como botões, caixas de texto, rótulos, etc., ao seu formulário conforme necessário.
3. Personalize as propriedades de cada controle usando a janela Propriedades.

4. Ajuste a aparência e o layout do formulário.

Introdução ao IronPrint

IronPrint é uma biblioteca de impressão abrangente desenvolvida pela Iron Software, projetada para integrar-se perfeitamente com aplicativos .NET. Esteja você trabalhando em um projeto de desktop, web ou móvel, o IronPrint oferece capacidades versáteis de impressão de documentos PDF, suportando vários formatos de arquivo e fornecendo configurações de impressão personalizáveis.

Principais características

1. Suporte a Formatos: IronPrint suporta vários formatos de documento, incluindo PDF, PNG, TIFF, GIF, JPEG e BITMAP. Esta versatilidade garante que os desenvolvedores possam trabalhar com diferentes tipos de conteúdo para impressão.
2. Configurações Personalizáveis: Os desenvolvedores podem personalizar as configurações de impressão conforme os requisitos de seu aplicativo. Isso inclui opções para definir DPI (pontos por polegada), especificar a orientação do papel (retrato ou paisagem) e controlar o número de cópias.
3. Diálogo de Impressão: IronPrint facilita uma experiência de usuário perfeita, permitindo que os desenvolvedores mostrem um diálogo de impressão antes de imprimir. Isso pode ser útil em cenários em que os usuários precisam interagir com o processo de impressão e selecionar opções específicas.
4. Impressão Silenciosa: IronPrint oferece um recurso de impressão silenciosa que é particularmente benéfico para automação e aumento da eficiência do fluxo de trabalho. Isso permite que os desenvolvedores imprimam faturas sem interação do usuário, eliminando a necessidade de intervenção manual e agilizando o processo geral.
5. Compatibilidade entre Plataformas: IronPrint vai além das limitações de plataforma, oferecendo compatibilidade com uma ampla gama de ambientes, incluindo Windows (7+), macOS (10+), iOS (11+) e Android API 21+ (v5 'Lollipop'). Ele se integra perfeitamente com diferentes tipos de projeto, como Móvel (Xamarin, MAUI e Avalonia), Desktop (WPF, MAUI e Windows Avalonia) e Console (App e Biblioteca).
6. Suporte Amplo a Versões .NET: Esteja você usando o último .NET 8, 7, 6, ou Core 3.1+, IronPrint está coberto. Ele também suporta o .NET Framework (4.6.2+), garantindo compatibilidade em vários ambientes de desenvolvimento.

Instalando IronPrint

Antes de mergulhar na impressão de arquivos, você precisa instalar a biblioteca IronPrint. Você pode fazer isso facilmente usando o Console do Gerenciador de Pacotes NuGet:

Install-Package IronPrint

Esta linha de comando irá baixar e instalar a biblioteca IronPrint no seu projeto C#.

Inicializando IronPrint

Uma vez que o IronPrint está instalado, você precisa inicializá-lo no seu código C#. Importe o namespace IronPrint e defina a chave de licença para garantir o funcionamento adequado:

using IronPrint;
class Program
{
    public static void Main()
    {
        License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
    }
}

using IronPrint;
class Program
{
    public static void Main()
    {
        License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
    }
}

Imprimindo um Arquivo com IronPrint

Imprimir um arquivo usando o IronPrint é simples. Você pode usar a classe Printer, especificando o caminho do arquivo para o método Print para imprimir um PDF silenciosamente:

using IronPrint;
class Program
{
    public static void Main()
    {
        License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
        // Specify the file path
        var document = "C:\\path\\to\\your\\file.pdf";
        // Print PDFs
        Printer.Print(document);
    }
}

using IronPrint;
class Program
{
    public static void Main()
    {
        License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
        // Specify the file path
        var document = "C:\\path\\to\\your\\file.pdf";
        // Print PDFs
        Printer.Print(document);
    }
}

Imprimir silenciosamente vem com o benefício de não precisar de qualquer interação do usuário para imprimir o PDF, o que é útil para situações onde a automação é necessária para agilizar o fluxo de trabalho. Para situações que exigem interação do usuário, como uma caixa de diálogo antes da impressão, você pode usar ShowPrintDialog, que atinge o mesmo resultado, mas com um diálogo como etapa adicional.

Embora este exemplo demonstre apenas a impressão de um arquivo PDF, o IronPrint também suporta vários formatos de arquivo, incluindo PDF, PNG, TIFF, GIF, JPEG, IMAGE e BITMAP.

Personalizando Configurações de Impressão

O IronPrint permite que você personalize as configurações de impressão de acordo com os requisitos do seu aplicativo. Você pode configurar configurações como DPI, número de cópias, orientação do papel e mais usando a classe PrintSettings. O seguinte exemplo de código ajuda você a definir as configurações de página e imprimir documentos PDF:

using IronPrint;
class Program
{
    public static void Main()
    {
        IronPrint.License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
        Console.WriteLine("Printing Started...");
        // Specify the file path
        string filePath = "C:\\path\\to\\your\\file.pdf";
        // Configure print settings
        PrintSettings printSettings = new PrintSettings();
        printSettings.Dpi = 300;
        printSettings.NumberOfCopies = 2;
        printSettings.PaperOrientation = PaperOrientation.Landscape;
        // Print the document with custom settings
        Printer.Print(filePath, printSettings);
        // Print using the Print dialog
        Printer.ShowPrintDialog(filePath, printSettings);
    }
}

using IronPrint;
class Program
{
    public static void Main()
    {
        IronPrint.License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
        Console.WriteLine("Printing Started...");
        // Specify the file path
        string filePath = "C:\\path\\to\\your\\file.pdf";
        // Configure print settings
        PrintSettings printSettings = new PrintSettings();
        printSettings.Dpi = 300;
        printSettings.NumberOfCopies = 2;
        printSettings.PaperOrientation = PaperOrientation.Landscape;
        // Print the document with custom settings
        Printer.Print(filePath, printSettings);
        // Print using the Print dialog
        Printer.ShowPrintDialog(filePath, printSettings);
    }
}

Aqui está como a saída se parece:

Se a impressora física não estiver instalada, então a impressora padrão é usada para imprimir documentos PDF. Para obter todas as impressoras disponíveis, você também pode usar o método GetPrinterNames.

// Retrieve printers' name
List<string> printersName = Printer.GetPrinterNames();
foreach (string printer in printersName)
{
    Console.WriteLine(printer);
}

// Retrieve printers' name
List<string> printersName = Printer.GetPrinterNames();
foreach (string printer in printersName)
{
    Console.WriteLine(printer);
}

Para informações mais detalhadas, por favor visite a página de documentação.