Obracanie tekstu i stron PDF w C# za pomocą IronPDF

Jakie metody powinienem użyć dla różnych scenariuszy obrotu?

Użyj metod SetPageRotation, SetPageRotations i SetAllPageRotations, aby ustawić obrót odpowiednio dla jednej strony, wielu stron i wszystkich stron. Te metody całkowicie nadpisują bieżący obrót strony z podanym stopniem, mierzonym zgodnie z ruchem wskazówek zegara. Jeśli oryginalny obrót strony już zgadza się z pożądanym stopniem, metody nie wpłyną na plik wyjściowy.

Biblioteka IronPdf zapewnia kompleksowe możliwości orientacji i obracania stron, które płynnie integrują się z istniejącymi procesami pracy z plikami PDF. Niezależnie od tego, czy pracujesz z nowo utworzonymi PDF-ami czy istniejącymi dokumentami, te metody obrotu oferują precyzyjną kontrolę nad orientacją strony bez wpływu na rzeczywistą strukturę treści.

Jakie kąty obrotu są obsługiwane?

IronPDF obsługuje cztery standardowe kąty obrotu: 0° (brak obrotu), 90°, 180° oraz 270° w kierunku zgodnym z ruchem wskazówek zegara. Kąty te pokrywają wszystkie typowe wymagania dotyczące obrotu dokumentów PDF. Obrót jest stosowany na poziomie strony, co oznacza, że cała zawartość strony, w tym tekst, obrazy i grafika, obraca się jako jedna jednostka. To podejście zachowuje przestrzenne relacje między elementami na stronie.

: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")

Podczas pracy z obrotami stron, ważne jest zrozumienie, jak współdziałają one z innymi funkcjami PDF. Na przykład, jeśli używasz niestandardowych rozmiarów papieru, obrót zostanie zastosowany po ustawieniu rozmiaru strony. Oznacza to, że strona w orientacji pionowej obrócona o 90 stopni stanie się w praktyce stroną w orientacji poziomej.

Dłączego używać transformacji CSS3 zamiast obrotu strony?

Po konwersji HTML na PDF w .NET, może być konieczne programowe obracanie tekstu lub całych stron. Częstym wymaganiem jest renderowanie tekstu wyrównanego pionowo w PDF za pomocą HTML5 i CSS3. Transformacje CSS3 oferują bardziej szczegółową kontrolę w porównaniu do obrotu na poziomie strony, umożliwiając obrócenie pojedynczych elementów tekstowych lub sekcji przy zachowaniu reszty strony w jej oryginalnej orientacji.

To podejście jest szczególnie przydatne przy tworzeniu dokumentów z mieszanymi orientacjami, takich jak raporty z pionowymi etykietami na wykresach lub tabele z obróconymi nagłówkami. Proces konwersji HTML na PDF w IronPDF w pełni obsługuje transformacje CSS3, zapewniając, że twoja stylizowana zawartość pojawi się dokładnie tak, jak zamierzono, w końcowym PDF.

Jakie właściwości CSS kontrolują obrót tekstu?

CSS3 umożliwia obrót tekstu pod dowolnym kątem po konwersji HTML do formatu PDF przy użyciu biblioteki .NET IronPdf, którą zainstalowałeś wcześniej. Osiąga się to za pomocą stylu CSS3 transform: rotate(...), który umożliwia obrót dowolnego elementu HTML pod dowolnym kątem. Punkt początkowy obrotu można dostosować za pomocą właściwości transform-origin, co zapewnia pełną kontrolę nad punktem obrotu.

: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")

Właściwość transformacji CSS3 obsługuje różne jednostki obrotu, w tym stopnie (deg), radiany (rad), grady (grad) i obroty. Do generacji PDF najczęściej używane są stopnie. Można również łączyć obrót z innymi transformacjami, takimi jak skalowanie i przesuwanie, aby osiągnąć złożone efekty pozycjonowania. Podczas używania responsywnego CSS z IronPDF, te transformacje dostosowują się bezproblemowo do różnych rozmiarów i orientacji stron.

Dla bardziej zaawansowanych scenariuszy możesz chcieć zbadać transformację stron PDF programowo po wstępnym renderowaniu. To pozwala na zastosowanie dodatkowych transformacji do istniejących PDF-ów lub łączenie rotacji opartej na CSS z transformacjami na poziomie strony dla złożonych układów dokumentów.

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Sprawdź naszą stronę z samouczkami tutaj: Edycja PDF lub zbadaj jak tworzyć nowe PDF-y od podstaw z niestandardowymi orientacjami. Aby zarządzać różnymi orientacjami stron w jednym dokumencie, zobacz nasz przewodnik dotyczący orientacji portretowej i poziomej.