Orientação retrato e paisagem
Frequentemente, ao criar documentos PDF dinâmicos, você precisará personalizar a orientação do documento. É aqui 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, você usa:
PdfPaperOrientation.Portrait
Se você estiver trabalhando com documentos PDF existentes, você pode 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
SetPageRotationquando você estiver procurando rotacionar uma página específica dentro do PDF - Use
SetAllPageRotationsse você quiser girar todas as páginas de seu documento PDF
5 passos para configurar a orientação da página PDF
- var
renderer= novoChromePdfRenderer(); renderer.RenderingOptions.PaperOrientation=IronPdf.Rendering.PdfPaperOrientation.Landscape;- var newPdfFromHtml =
renderer.RenderHtmlAsPdf()("<h1> Olá mundo! </h1>"); - 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 ChromePdfRenderer(). Esta função irá criar um novo documento PDF a partir de conteúdo HTML ou de URL. Em seguida, antes de renderizar, a orientação do papel é definida usando renderer.RenderingOptions.PaperOrientation. Ao escolher PdfPaperOrientation.Landscape, o PDF gerado aparecerá em modo paisagem em vez de na orientação padrão retrato. Vamos usar o método de renderização RenderHtmlAsPdf, que pega 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, permitindo 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 rotaciona 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 .

