1. IronPDF
  2. Fehlersuche
  3. PDF-Seitengrößenänderung, Erweiterung und Transformation

PDF-Seitengröße ändern, erweitern und transformieren

Curtis Chau
Curtis Chau
Aktualisiert:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Wenn Sie das PDF-Layout programmatisch anpassen, hängt das Ergebnis davon ab, ob Sie die Seite selbst oder den Inhalt darin ändern. IronPDF bietet Ihnen drei verschiedene Methoden dafür: Resize, Extend und Transform. Die richtige Wahl hängt davon ab, ob Sie die Seitengröße ändern, Ränder hinzufügen oder Inhalte verschieben möchten.

Größe ändern

Verwenden Sie Resize, wenn Sie die Seitengröße ändern möchten, um die Seite zu vergrößern oder zu verkleinern.

public void Resize(double PageWidth, double PageHeight, MeasurementUnit Units)
public void Resize(double PageWidth, double PageHeight, MeasurementUnit Units)
Public Sub Resize(PageWidth As Double, PageHeight As Double, Units As MeasurementUnit)
End Sub
$vbLabelText   $csharpLabel

Resize ändert die physische Größe der Seite und skaliert den Inhalt, um in die neuen Dimensionen zu passen, damit alles sichtbar bleibt. Eine ursprünglich 210 mm x 297 mm große Seite, die auf 148 mm x 210 mm verkleinert wurde, wird zu A5, wobei ihr Inhalt in die kleinere Seite eingepasst ist.

WarnungDas Ändern der Größe skaliert den Inhalt zum Anpassen. Achten Sie auf Abschnitte, wenn Sie eine Seite erheblich verkleinern.

Erweitern

Verwenden Sie Extend, wenn Sie Leerraum oder Ränder um vorhandene Inhalte möchten, ohne das Layout, die Skalierung oder die Position des Inhalts zu ändern.

public void Extend(double ExtendLeft, double ExtendRight, double ExtendTop, double ExtendBottom, MeasurementUnit Units)
public void Extend(double ExtendLeft, double ExtendRight, double ExtendTop, double ExtendBottom, MeasurementUnit Units)
Public Sub Extend(ExtendLeft As Double, ExtendRight As Double, ExtendTop As Double, ExtendBottom As Double, Units As MeasurementUnit)
End Sub
$vbLabelText   $csharpLabel

Diese Methode fügt der Seite Platz hinzu, wodurch ihre Gesamtgröße erhöht wird, aber der vorhandene Inhalt bleibt genau an dem Ort, an dem er war. Ausgehend von einer 210 mm x 297 mm großen A4-Seite, die 10 mm links und rechts und 20 mm oben und unten hinzugefügt wird, ergibt sich eine Seite von 230 mm x 337 mm mit dem ursprünglichen Inhalt zentriert in seinem alten Bereich. Es ist praktisch für die Vorbereitung eines PDFs zum Drucken oder Binden, wenn zusätzliche Ränder benötigt werden.

Beispielhafte Eingaben

Ursprüngliche A4-PDF-Seite vor dem Erweitern der Ränder

Musterausgabe

PDF-Seite, nachdem Extend weiße Abstände um unveränderte Inhalte hinzugefügt hat

Transformieren

Verwenden Sie Transform, um den tatsächlichen Inhalt auf der Seite zu bewegen oder zu skalieren, während die physische Seitengröße unverändert bleibt.

public void Transform(double MoveX, double MoveY, double ScaleX, double ScaleY)
public void Transform(double MoveX, double MoveY, double ScaleX, double ScaleY)
Public Sub Transform(MoveX As Double, MoveY As Double, ScaleX As Double, ScaleY As Double)
End Sub
$vbLabelText   $csharpLabel

Die Seitendimensionen bleiben gleich; nur wie der Inhalt erscheint, ändert sich. Durch das Übergeben von Werten, die den Inhalt um 10 mm nach rechts und 5 mm nach unten verschieben und ihn dann in beide Richtungen auf 80 % skalieren, wird der Inhalt an Ort und Stelle verschoben und verkleinert. Greifen Sie darauf zu, wenn Sie Layouts korrigieren, Inhalte ausrichten oder einen Zoom-out-Effekt anwenden.

Musterausgabe

PDF-Seite, nachdem Transform Inhalte innerhalb einer festen Seitengröße verschiebt und skaliert

Die Wahl zwischen ihnen

  • Größe ändern: Ändert die Seitengröße und skaliert den Inhalt damit; achten Sie auf mögliches Abschneiden.
  • Erweitern: Erweitert die Leinwand mit Leerzeichen und lässt den Inhalt unberührt.
  • Transformieren: Verschiebt oder skaliert den Inhalt, während die Seitendimensionen fest bleiben.

Diese Methoden lassen sich auch kombinieren. Ein häufiges Muster legt nahe, die Seite zu vergrößern und dann den Inhalt zu transformieren, um in die neuen Abmessungen zu passen.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 20,296,129 | Version: 2026.7 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.