Rotacione texto e páginas de PDF em C# com IronPDF

Quais métodos devo usar para diferentes cenários de rotação?

Use os métodos SetPageRotation, SetPageRotations e SetAllPageRotations para definir a rotação para uma única página, várias páginas e todas as páginas, respectivamente. Esses métodos sobrescrevem completamente a rotação atual da página com o grau especificado, medido no sentido horário. Se a rotação original da página já corresponder ao grau desejado, os métodos não afetarão o arquivo de saída.

A biblioteca IronPdf oferece capacidades abrangentes de orientação e rotação de página que se integram perfeitamente aos fluxos de trabalho de PDF existentes. Quer esteja a trabalhar com PDFs recém-criados ou com documentos existentes, estes métodos de rotação oferecem um controlo preciso sobre a orientação da página sem afetar a estrutura do conteúdo.

Quais ângulos de rotação são suportados?

IronPDF suporta quatro ângulos de rotação padrão: 0° (sem rotação), 90°, 180° e 270° no sentido horário. Esses ângulos cobrem todos os requisitos comuns de rotação para documentos PDF. A rotação é aplicada ao nível da página, o que significa que todo o conteúdo da página, incluindo texto, imagens e gráficos, gira como uma única unidade. Essa abordagem preserva as relações espaciais entre os elementos da página.

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

using IronPdf;
using IronPdf.Rendering;
using System.Linq;

// Import PDF
PdfDocument pdf = PdfDocument.FromFile("multi-page.pdf");

// Set rotation for a single page
pdf.SetPageRotation(0, PdfPageRotation.Clockwise90);

// Set rotation for multiple pages
pdf.SetPageRotations(Enumerable.Range(1,3), PdfPageRotation.Clockwise270);

// Set rotation for the entire document
pdf.SetAllPageRotations(PdfPageRotation.Clockwise180);

pdf.SaveAs("rotated.pdf");

Imports IronPdf
Imports IronPdf.Rendering
Imports System.Linq

' Import PDF
Private pdf As PdfDocument = PdfDocument.FromFile("multi-page.pdf")

' Set rotation for a single page
pdf.SetPageRotation(0, PdfPageRotation.Clockwise90)

' Set rotation for multiple pages
pdf.SetPageRotations(Enumerable.Range(1,3), PdfPageRotation.Clockwise270)

' Set rotation for the entire document
pdf.SetAllPageRotations(PdfPageRotation.Clockwise180)

pdf.SaveAs("rotated.pdf")

Ao trabalhar com rotações de página, é importante entender como elas interagem com outros recursos do PDF. Por exemplo, se você também estiver usando tamanhos de papel personalizados , a rotação será aplicada depois que o tamanho da página for definido. Isso significa que uma página em retrato rotacionada em 90 graus se tornará efetivamente orientada em paisagem.

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso

O IronSuite desempenha um papel crucial nas nossas operações. Estas são ferramentas que aumentam a eficiência no negócio, incluindo a criação de plantas baixas e melhoria na gestão de inventário.

David Jones

Engenheiro(a) de Software Líder, Agorus Build

Veja o estudo de caso

Por que usar a transformação CSS3 em vez da rotação da página?

Após converter HTML para PDF em .NET, você pode precisar rotacionar o texto ou páginas inteiras programaticamente. Uma necessidade frequente é renderizar texto alinhado verticalmente em PDFs usando HTML5 e CSS3. As transformações CSS3 oferecem um controle mais preciso em comparação com a rotação em nível de página, permitindo girar elementos ou seções de texto individuais, mantendo o restante da página em sua orientação original.

Essa abordagem é particularmente útil na criação de documentos com orientações mistas, como relatórios com rótulos verticais em gráficos ou tabelas com cabeçalhos rotacionados. O processo de conversão de HTML para PDF no IronPDF oferece suporte completo às transformações CSS3, garantindo que o conteúdo formatado apareça exatamente como desejado no PDF final.

Quais propriedades CSS controlam a rotação do texto?

CSS3 permite a rotação de texto em qualquer ângulo após converter HTML para PDF usando a biblioteca .NET IronPdf que você instalou anteriormente. Isso é obtido usando o estilo CSS3 transform: rotate(...), que pode rotacionar qualquer elemento HTML em qualquer ângulo. A origem da rotação pode ser personalizada usando a propriedade transform-origin, dando-lhe controle completo sobre o ponto de pivô da rotação.

:path=/static-assets/pdf/content-code-examples/how-to/rotating-text-css.cs

using IronPdf;

var renderer = new IronPdf.ChromePdfRenderer();

var pdf = renderer.RenderHtmlAsPdf(@"
<html>
<head>
 <style>
  .rotated{
  -webkit-transform: rotate(-180deg);
  width:400;
  height:400;
  }
</style>
</head>
<body>
<p class='rotated'>Rotated Text</p>
</body>
</html>
");

pdf.SaveAs("rotated.pdf");

Imports IronPdf

Private renderer = New IronPdf.ChromePdfRenderer()

Private pdf = renderer.RenderHtmlAsPdf("
<html>
<head>
 <style>
  .rotated{
  -webkit-transform: rotate(-180deg);
  width:400;
  height:400;
  }
</style>
</head>
<body>
<p class='rotated'>Rotated Text</p>
</body>
</html>
")

pdf.SaveAs("rotated.pdf")

A propriedade CSS3 transform suporta várias unidades de rotação, incluindo graus (deg), radianos (rad), grados (grad) e rotações. Para geração de PDFs, geralmente são utilizados graus de liberdade. Você também pode combinar a rotação com outras transformações, como escala e translação, para obter efeitos de posicionamento complexos. Ao usar CSS responsivo com o IronPDF, essas transformações se adaptam perfeitamente a diferentes tamanhos e orientações de página.

Para cenários mais avançados, você pode explorar a possibilidade de transformar páginas PDF programaticamente após a renderização inicial. Isso permite aplicar transformações adicionais a PDFs existentes ou combinar rotações baseadas em CSS com transformações em nível de página para layouts de documentos complexos.

Pronto para ver o que mais você pode fazer? Confira nossa página de tutoriais aqui: Editar PDFs ou explore como criar novos PDFs do zero com orientações personalizadas. Para gerenciar diferentes orientações de página dentro do mesmo documento, consulte nosso guia sobre orientação retrato e paisagem .