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 de uma única página, de várias páginas e de 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 recursos abrangentes de orientação e rotação de páginas 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?

O IronPDF suporta quatro ângulos de rotação padrão: 0° (sem rotação), 90°, 180° e 270° no sentido horário. Esses ângulos abrangem 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 formato retrato, girada em 90 graus, ficará efetivamente orientada em formato paisagem.

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?

O CSS3 permite a rotação do texto em qualquer ângulo após a conversão de HTML para PDF usando a biblioteca IronPDF .NET que você instalou anteriormente. Isso é conseguido 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 a você controle total 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 .