FitMode - TPdfView - PDFium Delphi Component

Komponente: TPdfView · Unit: PDFium

Steuert, wie die aktuelle Seite im Client-Bereich des Viewers sitzt; wird bei Größenänderung und Seitenwechsel automatisch erneut angewendet, sodass lange Dokumente mit gemischten Seitenformaten eingerahmt bleiben

Syntax

property FitMode: TPdfFitMode;

Beschreibung

FitMode ist der Standard-Seitenansicht-Umschalter für ganze Seite / Seitenbreite / Seitenhöhe, als published-Eigenschaft verfügbar gemacht, damit Anwendungen eine TPdfView auf ein Formular ziehen und ein Layout wählen können, ohne Zoom-Mathematik zu schreiben. Jeder Wert bildet ein klares visuelles Verhalten ab:

pfmNone — manueller Zoom. Welchen Zoom auch immer die Anwendung oder der Endnutzer setzt, er wird exakt beachtet. Dies ist der Standard, um das Verhalten vor v1.19.0 für bestehende Anwendungen zu bewahren.
pfmActualSize — 100%. Rendert eine PDF-User-Unit (1/72 Zoll) pro CSS-Pixel.
pfmFitPage — die gesamte Seite passt in den Viewport. Die Ansicht wählt den kleineren der Zoomfaktoren für Seitenbreite und Seitenhöhe.
pfmFitWidth — die Seitenbreite entspricht der Viewport-Breite; in der Höhe wird gescrollt. Gut für lange Dokumente, die von oben nach unten gelesen werden.
pfmFitHeight — die Seitenhöhe entspricht der Viewport-Höhe; in der Breite wird bei Bedarf gescrollt. Gut für Präsentationen und Querformat-Seiten.

Der aktive Anpassungsmodus wird automatisch erneut angewendet, wenn das Steuerelement in der Größe verändert wird und wenn die aktuelle Seite wechselt — das ist der eigentliche Sinn von FitMode gegenüber einer einmaligen Zoom-Zuweisung. Lange Dokumente mit gemischten Seitenformaten (etwa ein Hochformat-Cover, gefolgt von Querformat-Aufschlägen) bleiben perfekt eingerahmt, ohne einen zusätzlichen Resize-/OnPageChange-Handler

Ein direktes Setzen von Zoom bricht den aktiven Anpassungsmodus ab und setzt FitMode auf pfmNone zurück, passend zur Standard-Konvention von PDF-Viewern, bei der die Eingabe eines Zoomprozentsatzes aus „Ganze Seite“ / „Seitenbreite“ / „Seitenhöhe“ aussteigt. So bleibt der Eigenschaftswert ehrlich: FitMode <> pfmNone bedeutet „die Ansicht passt sich beim nächsten Layout-Ereignis erneut an“

Hinweise

FitMode cached den gewählten Zoom NICHT — die Berechnung läuft jedes Mal, wenn der aktive Anpassungsmodus erneut angewendet wird, sodass ein Wechsel der Rotation, eine Fenstergrößenänderung oder das Blättern zu einer anders formatierten Seite immer den korrekten Zoom liefert
Kombinieren Sie FitMode = pfmFitWidth mit SmoothScroll für das klassische „Lese-Modus für lange Dokumente“-Gefühl
Wenn die Host-Anwendung eine Knopfleiste „Ganze Seite“ / „Seitenbreite“ / „Seitenhöhe“ anbieten möchte, weisen Sie einfach FitMode zu — keine zusätzliche Zoom-Berechnung nötig

Beispiel

// Whole page fits in viewport, even after resize / page change
PdfView1.FitMode := pfmFitPage;

// Page width matches viewport width — long-document reading mode
PdfView1.FitMode := pfmFitWidth;

// Page height matches viewport height — presentation mode
PdfView1.FitMode := pfmFitHeight;

// 100% — one PDF point per pixel
PdfView1.FitMode := pfmActualSize;

// User types a zoom value → drop out of fit mode
PdfView1.Zoom := 1.5;
Assert(PdfView1.FitMode = pfmNone);

Siehe auch

Zoom, PageZoom, PageWidthZoom, PageHeightZoom, ActualSizeZoom