Como configurar oDPIde impressão em C

Como ConfigurarDPIde Impressão em C#?

A propriedade Dpi em PrintSettings aceita qualquer número inteiro positivo. O valor padrão é 300, que é a resolução padrão para documentos comerciais. ODPIreal usado para impressão pode ser limitado pelas capacidades da impressora física — se definirmos 1200DPIem uma impressora que atinge no máximo 600, a impressora usará sua resolução mais alta suportada.

:path=/static-assets/print/content-code-examples/how-to/set-the-dpi/set-the-dpi-office-and-high-res-dpi.cs

using IronPrint;

// Configure 300 DPI for standard office quality
var officeSettings = new PrintSettings
{
    Dpi = 300
};

// Print the invoice
Printer.Print("invoice.pdf", officeSettings);

Imports IronPrint

' Configure 300 DPI for standard office quality
Dim officeSettings As New PrintSettings With {
    .Dpi = 300
}

' Print the invoice
Printer.Print("invoice.pdf", officeSettings)

Com o .NET nativo, controlar a resolução de impressão requer a criação de um PrintDocument , o acesso a DefaultPageSettings.PrinterResolution , o tratamento do evento PrintPage e a renderização manual do conteúdo com Graphics.DrawImage(). Isso envolve 15–25 linhas de código modelo. IronPrint reduz isso a uma única propriedade de inteiro em um objeto de configurações.

QualDPIdevo usar para diferentes trabalhos de impressão?

Escolher oDPIcerto depende do tipo de conteúdo e do propósito. Resolução mais alta nem sempre é melhor — ela aumenta o tamanho do spool e o tempo de impressão sem benefício visível para documentos ricos em texto.

Para a maioria das aplicações, 300DPIoferece o melhor equilíbrio entre qualidade e desempenho. Recomendamos começar com o padrão e aumentar apenas quando a saída exigir melhoria visível na clareza da imagem ou detalhe fino.

Como combinarDPIcom outras configurações de impressão?

ODPIfunciona em conjunto com outras propriedades PrintSettings para definir um trabalho de impressão completo. Podemos configurar o tamanho do papel, orientação, margens, cópias e modo em escala de cinza no mesmo objeto.

:path=/static-assets/print/content-code-examples/how-to/set-the-dpi/set-the-dpi-combine-dpi-with-settings.cs

using IronPrint;

// Combine 600 DPI with landscape A4 and grayscale output
var settings = new PrintSettings
{
    Dpi = 600,
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    PaperMargins = new Margins(10, 10, 10, 10),
    NumberOfCopies = 2,
    Grayscale = true
};

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

Imports IronPrint

' Combine 600 DPI with landscape A4 and grayscale output
Dim settings As New PrintSettings With {
    .Dpi = 600,
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .PaperMargins = New Margins(10, 10, 10, 10),
    .NumberOfCopies = 2,
    .Grayscale = True
}

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

A configuração Grayscale = true em 600DPIproduz uma saída monocromática nítida, ideal para gráficos e tabelas de dados. Os valores PaperMargins estão em milímetros.

Como permitir que os usuários ajustem oDPIno diálogo de impressão?

Quando passamos PrintSettings para Printer.ShowPrintDialog(), a caixa de diálogo é aberta com oDPIpredefinido. O usuário pode aceitá-lo ou ajustar a resolução antes de imprimir.

:path=/static-assets/print/content-code-examples/how-to/set-the-dpi/set-the-dpi-dialog-with-dpi-preset.cs

using IronPrint;

// Pre-configure 600 DPI for the dialog
var settings = new PrintSettings
{
    Dpi = 600,
    PaperSize = PaperSize.Letter
};

// Open the dialog with pre-selected DPI
Printer.ShowPrintDialog("design-proof.pdf", settings);

Imports IronPrint

' Pre-configure 600 DPI for the dialog
Dim settings As New PrintSettings With {
    .Dpi = 600,
    .PaperSize = PaperSize.Letter
}

' Open the dialog with pre-selected DPI
Printer.ShowPrintDialog("design-proof.pdf", settings)

Para cenários de interface do usuário que não bloqueiam a impressão, Printer.ShowPrintDialogAsync() aceita os mesmos parâmetros e mantém o aplicativo responsivo. A caixa de diálogo permite que os usuários verifiquem a resolução (DPI) em relação às resoluções suportadas pela impressora antes de imprimir — útil ao alternar entre uma impressora a laser de escritório de 600DPIe uma impressora fotográfica de 1200 DPI. Para fluxos de trabalho totalmente automatizados onde não é necessária interação do usuário, use Printer.Print() para impressão silenciosa .

Próximos passos

DPI é um único número inteiro no objeto PrintSettings — defina-o para corresponder aos requisitos de qualidade de cada trabalho de impressão. Comece com 300 para documentos comerciais e aumente para 600 ou mais para saídas ricas em gráficos.

Explore o guia de configurações de impressão para cada propriedade disponível, a referência da API da classe Printer para todos os métodos disponíveis, e a página de exemplos de código para snippets prontos para uso. Os tutoriais do IronPrint percorrem todo o ciclo de vida da impressão, e o changelog acompanha as atualizações recentes.

Comece um teste gratuito de 30 dias para testar configurações deDPIem um projeto ao vivo. Quando estiver pronto, veja as opções de licenciamento a partir de $999.