Cómo establecer la orientación y rotación de páginas en .NET C#

¿Cuándo debo utilizar la orientación horizontal?

La orientación horizontal es ideal para contenidos que requieren más espacio horizontal, como tablas anchas, gráficos, cuadros de mando o presentaciones. Cuando convierta archivos HTML a PDF, el modo apaisado garantiza que el contenido ancho se muestre correctamente, sin que se produzcan envolturas de texto o desbordamientos de elementos no deseados. Esta orientación es especialmente útil para informes que contengan datos financieros, cronogramas de proyectos o cualquier contenido diseñado para su visualización en pantalla panorámica.

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-orientation.cs

using IronPdf;
using IronPdf.Rendering;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Change paper orientation
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;

PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("landscape.pdf");

La clase ChromePdfRenderer ofrece flexibilidad adicional a la hora de establecer la orientación. También puede especificar tamaños de papel personalizados junto con ajustes de orientación para crear PDF que cumplan las especificaciones exactas. Esto es especialmente valioso cuando se crean documentos para requisitos de impresión especializados o formatos de visualización únicos.

¿Cómo es el resultado final?

¿Qué métodos debo utilizar para rotar las páginas?

Utilice los métodos siguientes para establecer la rotación de una sola página, de varias páginas o de todas las páginas.

• SetAllPageRotations: Establece el grado de rotación para todas las páginas.
• SetPageRotation: Establece el grado de rotación para una sola página.
• SetPageRotations: Establece el grado de rotación para una lista seleccionada de páginas.

Los métodos de rotación de IronPDF funcionan a la perfección con otras funciones de manipulación de páginas. Puede combinar la rotación con otras operaciones de transformación para lograr diseños de documentos complejos, o utilizarlas junto con métodos para rotar texto y páginas para crear estructuras de documentos sofisticadas.

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-set-rotation.cs

using IronPdf;
using IronPdf.Rendering;
using System.Collections.Generic;

PdfDocument pdf = PdfDocument.FromFile("landscape.pdf");

// Set all pages
pdf.SetAllPageRotations(PdfPageRotation.Clockwise90);

// Set a single page
pdf.SetPageRotation(1, PdfPageRotation.Clockwise180);

// Set multiple pages
List<int> selectedPages = new List<int>() { 0, 3 };
pdf.SetPageRotations(selectedPages, PdfPageRotation.Clockwise270);

pdf.SaveAs("rotatedLandscape.pdf");

Cuando se trabaja con rotación, es importante entender que la operación afecta a todo el contenido de la página, incluido el texto, las imágenes y cualquier anotación. Esto difiere de la rotación específica de texto, que solo afecta a elementos de texto individuales. Para obtener un control más detallado sobre el diseño del documento, explore el completo Tutorial de creación de PDF que cubre técnicas avanzadas de formato.

¿Qué aspecto tiene el PDF girado?

¿Cómo puedo comprobar la rotación actual de la página?

Usa el método GetPageRotation para recuperar la rotación de cualquier página en particular en el documento PDF. Simplemente proporciona el índice de la página al método.

Este método es especialmente útil cuando se procesan documentos con orientaciones mixtas o cuando es necesario mantener una rotación coherente en los documentos fusionados. La capacidad de consultar los estados de rotación actuales permite flujos de trabajo inteligentes de procesamiento de documentos, especialmente cuando se combina con otros ejemplos de orientación de página.

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-get-rotation.cs

using IronPdf;
using IronPdf.Rendering;

PdfDocument pdf = PdfDocument.FromFile("rotatedLandscape.pdf");

PdfPageRotation rotation = pdf.GetPageRotation(1);