Como configurar oDPIde impressão em C

Como ConfigurarDPIde Impressão em C#?

A propriedade Dpi na 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 .NET nativo, controlar a resolução de impressão requer a criação de um PrintDocument, acessando DefaultPageSettings.PrinterResolution, lidando com o evento PrintPage, e renderizando manualmente o 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?

DPI funciona junto 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)

Definir Grayscale = true a 600DPIproduz uma saída monocromática nítida que é ideal para gráficos e tabelas de dados. Os valores PaperMargins são em milímetros.

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

Quando passamos PrintSettings para Printer.ShowPrintDialog(), o diálogo se abre com nossoDPIpredefinido. 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 UI não bloqueantes, Printer.ShowPrintDialogAsync() aceita os mesmos parâmetros e mantém o aplicativo responsivo. O diálogo permite que os usuários verifiquem oDPIem 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 de fotos de 1200 DPI. Para fluxos de trabalho totalmente automatizados onde não é necessária a interação do usuário, use Printer.Print() para impressão silenciosa em vez disso.

Próximos passos

DPI é um único 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 licença começando em $999.