Orientação retrato e paisagem
Frequentemente, ao criar documentos PDF dinâmicos, você precisará personalizar a orientação do documento. É aí que entra o PaperOrientation do IronPDF. Esta ferramenta permite que os desenvolvedores acessem a classe PdfPaperOrientation. Com isso, você pode escolher entre a orientação de página paisagem ou retrato ao renderizar documentos PDF a partir de conteúdo HTML ou de URL.
- Para orientação paisagem, você usaria:
PdfPaperOrientation.Landscape - Para orientação retrato, utilize:
PdfPaperOrientation.Portrait
Se você estiver trabalhando com documentos PDF existentes, poderá usar o PageRotation para personalizar a orientação do documento PDF. Para definir a rotação das páginas em seu documento, você deve:
Use SetPageRotation quando quiser rotacionar uma página específica dentro do PDF.
Use SetAllPageRotations se quiser rotacionar todas as páginas do seu documento PDF.
- var renderizador = novo ChromePdfRenderer();
- renderer.RenderingOptions.PaperOrientation = IronPDF;
- var newPdfFromHtml = renderer.RenderHtmlAsPdf("
Hello World!
"); - var existingPdf = new PdfDocument("old_report.pdf");
- existingPdf.SetPageRotation(0, PdfPageRotation.Clockwise90);
Para começar, precisamos decidir se vamos usar um documento PDF existente ou se vamos gerar um novo. Primeiro, vamos analisar os passos para definir a orientação de um documento PDF recém-renderizado e, em seguida, como isso funciona para um PDF já existente.
Primeiro, você precisará criar uma nova instância de ChromePdfRenderer(). Esta função irá criar um novo documento PDF a partir de conteúdo HTML ou de URL. Em seguida, antes da renderização, a orientação do papel é definida usando renderer.RenderingOptions.PaperOrientation. Ao selecionar PdfPaperOrientation.Landscape, o PDF gerado aparecerá no modo paisagem em vez da orientação retrato padrão. Usaremos o método de renderização RenderHtmlAsPdf, que recebe uma string HTML e a converte instantaneamente em um PDF.
Agora, vamos ver como você pode definir uma orientação personalizada para documentos PDF existentes. Primeiro, carregaremos um arquivo chamado old_report.pdf em um objeto PdfDocument, dando acesso às suas páginas. Usando Pages[0].PageRotation, você pode verificar o estado de rotação da primeira página. Para fazer alterações, SetPageRotation gira uma única página, neste caso, girando a página um em 90 graus no sentido horário.
Em conjunto, esses exemplos ilustram como o IronPDF não apenas cria PDFs refinados a partir de HTML e fontes da web, mas também fornece ferramentas poderosas para ajustar a orientação e a rotação da página em documentos PDF existentes, otimizando os fluxos de trabalho de PDF para desenvolvedores .NET .

