Cómo Configurar el Tamaño del Papel para Imprimir en C

¿Cómo Configuro el Tamaño del Papel Al Imprimir en C#?

Establecemos el tamaño del papel asignando un valor del enum PaperSize a la propiedad PaperSize en un objeto PrintSettings. Luego pasamos ese objeto a cualquiera de los métodos de impresión de IronPrint.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-set-paper-size.cs

using IronPrint;

// Configure print settings with US Letter paper
PrintSettings settings = new PrintSettings();
settings.PaperSize = PaperSize.Letter;

// Print to the default printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with US Letter paper
Dim settings As New PrintSettings()
settings.PaperSize = PaperSize.Letter

' Print to the default printer
Printer.Print("invoice.pdf", settings)

Primero instanciamos PrintSettings, que se inicializa con los valores predeterminados de la impresora. Luego sobreescribimos PaperSize con PaperSize.Letter, que se corresponde con el formato estándar de 8.5 × 11 pulgadas. Cuando llamamos a Printer.Print, IronPrint envía el documento a la impresora predeterminada del sistema utilizando ese tamaño de papel.

Si no se especifica PaperSize, IronPrint utiliza PaperSize.PrinterDefault, que se ajusta a cualquier tamaño de papel que la impresora predeterminada del sistema operativo esté configurada para usar. Este es un detalle esencial para entornos de producción donde las configuraciones de impresoras difieren entre máquinas.

¿Qué Tamaños de Papel Soporta la Biblioteca?

El enum PaperSize incluye doce valores que cubren estándares internacionales ISO, tamaños comunes de EE.UU. y el predeterminado de la impresora. La tabla a continuación enumera cada opción disponible.

Cada valor se mapea directamente a un estándar de papel bien conocido. La opción PrinterDefault indica a IronPrint que utilice el tamaño para el que la impresora está configurada actualmente, lo que es útil cuando se quiere respetar las preferencias del usuario final de la impresora en lugar de imponer un formato específico.

Para una referencia completa de la API, ver la documentación de la clase PaperSize.

¿Cómo Combino Tamaño de Papel con Otras Configuraciones de Impresión?

La clase PrintSettings expone varias propiedades más allá de PaperSize. Podemos configurar orientación, DPI, márgenes, número de copias y modo en escala de grises — todo en un solo objeto.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-combined-settings.cs

using IronPrint;

// Configure full print settings
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

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

Imports IronPrint

' Configure full print settings
Dim settings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 300,
    .NumberOfCopies = 3,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

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

Usamos la sintaxis del inicializador de objetos aquí por claridad. Orientation rota la hoja A4 hacia su eje más ancho. DPI a 300 asegura una salida nítida para gráficos y texto fino. Margins acepta cuatro valores en milímetros — superior, derecho, inferior, izquierdo — a través del constructor Margins. La propiedad CopyCount tiene por defecto 1, pero la configuramos explícitamente para mejorar la legibilidad.

Estas propiedades trabajan juntas sin conflictos. IronPrint valida la configuración y transmite las configuraciones combinadas al controlador de la impresora como un solo trabajo de impresión. Para configuraciones más avanzadas como selección de impresora y configuración de bandeja, consulte la guía completa de configuración de impresión.

¿Cómo Imprimo Asíncronamente con un Tamaño de Papel Personalizado?

Para aplicaciones donde bloquear el hilo principal no es una opción — como aplicaciones WPF o WinForms — utilizamos Printer.PrintAsync. El método acepta el mismo objeto PrintSettings y devuelve un Task.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-async-print.cs

using IronPrint;
using System.Threading.Tasks;

public class DocumentPrinter
{
    public async Task PrintLegalDocumentAsync(string filePath)
    {
        // Configure Legal paper size
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print asynchronously
        await Printer.PrintAsync(filePath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class DocumentPrinter
    Public Async Function PrintLegalDocumentAsync(filePath As String) As Task
        ' Configure Legal paper size
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

Este ejemplo basado en clases demuestra un patrón realista donde un servicio DocumentPrinter envuelve la lógica de impresión. Configuramos PaperSize.Legal (8.5 × 14 pulgadas), que es el formato estándar para contratos y documentos legales. La palabra clave await garantiza que el hilo de llamada se mantenga receptivo mientras IronPrint procesa el trabajo de impresión.

Podemos llamar a este método desde un controlador de clic de botón, un servicio en segundo plano o en cualquier lugar donde se soporte await. Los métodos asíncronos de IronPrint — incluyendo PrintAsync y ShowPrintDialogAsync — aceptan la misma configuración PrintSettings, por lo que el comportamiento del tamaño del papel es idéntico entre las rutas síncronas y asíncronas.

¿Cuales son mis próximos pasos?

Cubrimos cómo establecer el tamaño del papel en C# usando el enum PaperSize de IronPrint, desde la configuración básica de una sola propiedad hasta la configuración combinada y la impresión asincrónica. La clase PrintSettings proporciona una API limpia y fuertemente tipada que elimina las conjeturas sobre las dimensiones del papel.

Para continuar explorando las capacidades de IronPrint:

• Aprende a configurar todas las configuraciones de impresión incluyendo el nombre de la impresora, bandeja y escala de grises
• Ver ejemplos de código de configuración de impresión en funcionamiento para escenarios comunes
• Explore la referencia API completa para clases como Printer, PrintSettings, PaperSize

Empieza una prueba gratuita de 30 días para probar la configuración de tamaño de papel en tus propios proyectos, o ver opciones de licencia para despliegue en producción.

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false