¿Cómo establecer la orientación del papel para imprimir en C&#35

¿Cómo Configuro la Orientación del Papel para Imprimir?

La propiedad PaperOrientation en PrintSettings acepta tres valores:

• PaperOrientation.Portrait — disposición vertical (predeterminada en la mayoría de las impresoras). Lo mejor para documentos de una sola columna como cartas, contratos y facturas. En España, es la orientación exigida para facturas VeriFactu, declaraciones de la AEAT y documentos administrativos presentados ante organismos públicos (FACe, BOE).
• PaperOrientation.Landscape — disposición horizontal. Lo mejor para contenido ancho como tablas de datos, diagramas de Gantt, hojas de cálculo y presentaciones de diapositivas. Utilizado en informes de la CNMV con tablas financieras extendidas y en presentaciones de auditoría para el Esquema Nacional de Seguridad (ENS).
• PaperOrientation.Automatic — se remite a la configuración predeterminada de la impresora.

Creamos un objeto PrintSettings, asignamos la orientación deseada y lo pasamos a Printer.Print() para impresión silenciosa o a Printer.ShowPrintDialog() para impresión con diálogo.

:path=/static-assets/print/content-code-examples/how-to/set-paper-orientation/set-paper-orientation-portrait-and-landscape-orientation.cs

using IronPrint;

// Configure portrait orientation
var portraitSettings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Portrait
};

// Print the invoice in portrait
Printer.Print("invoice.pdf", portraitSettings);

// Configure landscape orientation
var landscapeSettings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape
};

// Print the dashboard in landscape
Printer.Print("quarterly-dashboard.pdf", landscapeSettings);

Imports IronPrint

' Configure portrait orientation
Dim portraitSettings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Portrait
}

' Print the invoice in portrait
Printer.Print("invoice.pdf", portraitSettings)

' Configure landscape orientation
Dim landscapeSettings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape
}

' Print the dashboard in landscape
Printer.Print("quarterly-dashboard.pdf", landscapeSettings)

Con el enfoque nativo de .NET System.Drawing.Printing, la orientación es un booleano (DefaultPageSettings.Landscape = true) enterrado dentro de un PrintDocument que también requiere manejo de eventos PrintPage, renderización de gráficos, y gestión manual de páginas. IronPrint reemplaza todo ese canal con una sola propiedad en un objeto de configuraciones.

Orientación del papel en el contexto fiscal y regulatorio español

La elección de la orientación correcta tiene implicaciones normativas en España. La siguiente tabla resume las orientaciones recomendadas según el tipo de documento:

La AEAT no especifica técnicamente la orientación en sus normativas de facturación electrónica, pero el formato A4 vertical es el estándar de facto en toda la Administración española y en los sistemas ERP homologados para VeriFactu y Facturae.

¿Cómo Combino Orientación con Otras Configuraciones de Impresión?

La orientación es más útil cuando se combina con el tamaño del papel, DPI y márgenes para definir un diseño de impresión completo. La clase PrintSettings nos permite configurar todo esto en un solo objeto.

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

using IronPrint;

// Combine orientation with paper size, DPI, and margins
var settings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape,
    PaperSize = PaperSize.A4,
    Dpi = 300,
    NumberOfCopies = 1,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

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

Imports IronPrint

' Combine orientation with paper size, DPI, and margins
Dim settings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape,
    .PaperSize = PaperSize.A4,
    .Dpi = 300,
    .NumberOfCopies = 1,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

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

PaperSize y PaperOrientation trabajan juntos — configurando A4 en horizontal se obtiene un área de impresión de 297 × 210 mm, mientras que A4 en vertical da 210 × 297 mm. La propiedad Dpi controla la resolución de salida (300 es el estándar para documentos de negocio, y también el mínimo recomendado para asegurar la legibilidad de los códigos QR de verificación fiscal como el QR de la AEAT en las facturas VeriFactu), y los valores PaperMargins están en milímetros.

using IronPrint;

// Configuración optimizada para facturas VeriFactu / documentos AEAT
var fiscalSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,  // DPI mínimo para legibilidad del QR de verificación AEAT
    PrinterName = "Impresora_Fiscal_Departamento"
};

Printer.Print("factura-verifactu.pdf", fiscalSettings);

using IronPrint;

// Configuración optimizada para facturas VeriFactu / documentos AEAT
var fiscalSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,  // DPI mínimo para legibilidad del QR de verificación AEAT
    PrinterName = "Impresora_Fiscal_Departamento"
};

Printer.Print("factura-verifactu.pdf", fiscalSettings);

Imports IronPrint

' Configuración optimizada para facturas VeriFactu / documentos AEAT
Dim fiscalSettings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,  ' DPI mínimo para legibilidad del QR de verificación AEAT
    .PrinterName = "Impresora_Fiscal_Departamento"
}

Printer.Print("factura-verifactu.pdf", fiscalSettings)

¿Cómo Dejo que los Usuarios elijan la Orientación en el Diálogo de Impresión?

Cuando pasamos PrintSettings a Printer.ShowPrintDialog(), el diálogo se abre con nuestra orientación preestablecida. El usuario puede aceptarlo o alternar entre retrato y paisaje antes de imprimir.

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

using IronPrint;

// Pre-configure landscape orientation for the dialog
var settings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape,
    PaperSize = PaperSize.Letter
};

// Open the dialog with pre-selected orientation
Printer.ShowPrintDialog("wide-report.pdf", settings);

Imports IronPrint

' Pre-configure landscape orientation for the dialog
Dim settings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape,
    .PaperSize = PaperSize.Letter
}

' Open the dialog with pre-selected orientation
Printer.ShowPrintDialog("wide-report.pdf", settings)

Para escenarios de UI no bloqueantes, la variante asincrónica Printer.ShowPrintDialogAsync() acepta los mismos parámetros y mantiene la aplicación receptiva mientras el diálogo está abierto. Esto es especialmente útil para la orientación porque los usuarios a menudo desean previsualizar cómo se ve un documento en retrato versus paisaje antes de comprometerse a una tirada de impresión. El tutorial de impresión de documentos cubre flujos de trabajo silenciosos y con diálogo de extremo a extremo.

En entornos de Back Office con documentos LOPDGDD (nóminas, contratos con datos personales), preestablecer Portrait A4 en el diálogo evita que el usuario cambie accidentalmente el formato, lo que podría afectar a la presentación de datos personales sensibles en la página impresa.

Próximos pasos

La orientación del papel es una propiedad en el objeto PrintSettings — configure PaperOrientation a Portrait, Landscape, o Automatic y páselo a cualquier método de impresión de IronPrint. Combínelo con PaperSize.A4, Dpi=300, y PaperMargins para control total del diseño, especialmente en documentos fiscales españoles que requieren cumplimiento con los estándares de la AEAT, VeriFactu, Facturae/FACe y las diputaciones forales para TicketBAI.

Explora el cómo configurar opciones de impresión para cada propiedad disponible, la referencia de la API de la clase Printer para el método completo, o la página de ejemplos de código para fragmentos listos para ejecutar. Los tutoriales de IronPrint recorren el ciclo completo de impresión, y el registro de cambios sigue las actualizaciones recientes que incluyen mejoras de rendimiento.

Empieza una prueba gratuita de 30 días para probar configuraciones de orientación en un proyecto en vivo. Cuando esté listo, vea las opciones de licencia comenzando en $999.