Cómo imprimir con un diálogo en C

Entrada

El quarterly-report.pdf pasado a ShowPrintDialog, un resumen financiero corporativo de Q3 con estilo y tarjetas de métricas KPI y tablas de ingresos por división, representa un documento empresarial típico enviado al cuadro de diálogo de impresión.

: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")

Resultado

Cuadro de diálogo de impresión nativo abierto por ShowPrintDialog para el informe trimestral.

El método acepta una ruta de archivo como un string o datos de archivo en bruto como un byte[]. IronPrint detecta el formato del documento, lo renderiza a través del motor adecuado y presenta el diálogo. Cuando el usuario confirma, el documento se imprime con las configuraciones elegidas. El tutorial de imprimir documento trata el ciclo de vida completo de la impresión con más detalle.

Entrada

El invoice.pdf pre-cargado con configuraciones A4 en retrato a 300 DPI: una factura profesional de facturación con elementos de línea, descuento, impuestos e instrucciones de transferencia electrónica, que muestra un documento realista donde la aplicación ya conoce el tamaño y orientación 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)

Resultado

Cuadro de diálogo de impresión nativo abierto con configuraciones de retrato A4 pre-configuradas.

Esto es útil cuando la aplicación sabe de antemano la impresora o el formato de papel probable. Por ejemplo, un sistema de punto de venta que siempre imprime recibos en una impresora térmica específica puede predefinir PrinterName para ese dispositivo. El usuario aún tiene la opción de cambiarlo en el cuadro de diálogo.

Para descubrir qué impresoras están disponibles en el sistema, llamamos a Printer.GetPrinterNames(), que devuelve un List<string> de todas las impresoras instaladas. De manera similar, Printer.GetPrinterTrays() devuelve las bandejas de papel disponibles para una impresora dada.

La lista completa de propiedades configurables incluye PrinterName, PaperSize, PaperOrientation, Dpi, NumberOfCopies, Grayscale, PaperMargins, Flatten (para campos de formulario PDF), y Tray. El cómo configurar las opciones de impresión cubre cada propiedad con ejemplos de código. Cualquier propiedad no establecida en PrintSettings por defecto a la configuración estándar de la impresora seleccionada.

Entrada

El informe.pdf esperado de manera asincrónica: un informe de infraestructura y seguridad de TI de varias secciones, representando el tipo de documento de formato largo donde la presentación de diálogo no bloqueante mantiene la UI reactiva mientras se carga el archivo.

: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")

Resultado

Cuadro de diálogo de impresión nativo abierto de forma asíncrona vía ShowPrintDialogAsync, con la consola confirmando la ejecución no bloqueante.

ShowPrintDialogAsync() acepta los mismos parámetros que la versión sincrónica: una ruta de archivo o un arreglo de bytes, más un objeto PrintSettings opcional. El patrón asincrónico sigue el mismo Patrón Asincrónico Basado en Tareas utilizado en todo el desarrollo moderno de .NET.

IronPrint funciona en aplicaciones WinForms, WPF, MAUI y de consola. La apariencia del diálogo se adapta a la plataforma anfitriona y a la versión del sistema operativo, de modo que el usuario siempre ve la ventana de impresión nativa que espera.

Entrada

monthly-report.pdf leído en un byte[], representando un documento recuperado de una base de datos o generado en memoria antes de ser enviado al cuadro 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)

Resultado

El diálogo se abre como se ve en los ejemplos anteriores. La detección de formato es automática: ya sea que pasemos una ruta de archivo o un byte[], IronPrint renderiza el documento y presenta el mismo diálogo nativo.

La página de ejemplos de código muestra escenarios adicionales específicos de formato. Para flujos de trabajo específicos de PDF (generar un PDF y imprimirlo inmediatamente), IronPDF se combina naturalmente con IronPrint.