Komplett ViewerPreferences-referens

ViewerPreferences låter dig styra hur PDF-dokument visas i viewers som stödjer dem och hur vissa default print settings initieras. Det aktuella HotPDF-biblioteket stöder 14 ViewerPreferences-värden plus den relaterade egenskapen InitialZoom

Aktuella datatyper

THPDFDirection = (LeftToRight, RightToLeft);
THPDFNonFullScreenPageMode = (
  nfpmUseNone, nfpmUseOutlines, nfpmUseThumbs, nfpmUseOC, nfpmUseAttachments
);
THPDFPrintScaling = (psNone, psAppDefault);
THPDFDuplex = (dupSimplex, dupDuplexFlipShortEdge, dupDuplexFlipLongEdge);
THPDFPageBoundary = (pbMediaBox, pbCropBox, pbBleedBox, pbTrimBox, pbArtBox);
THPDFInitialZoom = (
  FitNone, FitPage, FitWidth, FitHeight, FitBox, FitBoxWidth, FitBoxHeight,
  Zoom50, Zoom75, Zoom100, Zoom125, Zoom150, Zoom200
);

THPDFViewerPreference = (
  vpHideToolbar, vpHideMenubar, vpHideWindowUI, vpFitWindow, vpCenterWindow,
  vpDisplayDocTitle, vpDirection, vpNonFullScreenPageMode, vpPrintScaling,
  vpDuplex, vpPickTrayByPDFSize, vpNumCopies, vpPrintArea, vpPrintClip,
  vpViewArea, vpViewClip
);

THPDFViewerPreferences = set of THPDFViewerPreference;

ViewerPreferences som stöds

Alternativ	Tillhörande egenskap	Beskrivning
vpHideToolbar	Ingen	Döljer viewerns verktygsfält
vpHideMenubar	Ingen	Döljer viewerns menyrad
vpHideWindowUI	Ingen	Döljer UI-element som scroll bars och navigation controls
vpFitWindow	Ingen	Ändrar storlek på dokumentfönstret så att den första visade sidan passar
vpCenterWindow	Ingen	Centrerar dokumentfönstret på skärmen
vpDisplayDocTitle	Title	Visar dokumenttiteln i stället för filnamnet i viewerns caption
vpDirection	Direction	Lagrar den dominerande läsordningen med `LeftToRight` eller `RightToLeft`
vpNonFullScreenPageMode	NonFullScreenPageMode	Väljer page mode att använda efter att full-screen mode lämnats
vpPrintScaling	PrintScaling	Väljer `psNone` eller `psAppDefault` för default print scaling
vpDuplex	Duplex	Väljer utskriftsbeteende för simplex eller duplex
vpPickTrayByPDFSize	Ingen	Begär val av printer tray baserat på PDF-sidstorleken
vpNumCopies	NumCopies	Lagrar föreslaget antal utskriftskopior
vpPrintArea	PrintArea	Väljer page boundary som används för print rendering
vpPrintClip	PrintClip	Väljer page boundary som används för print clipping
vpViewArea	ViewArea	Page boundary som används för on-screen view area (PDF 1.4 12.2). Tillgängligt sedan HotPDF v2.29.0
vpViewClip	ViewClip	Page boundary som används för on-screen view clipping (PDF 1.4 12.2). Tillgängligt sedan HotPDF v2.29.0

Värden för tillhörande egenskaper

Dessa egenskaper skrivs bara när motsvarande ViewerPreferences-flagga är aktiverad

Egenskap	Värden
Direction	LeftToRight, RightToLeft
NonFullScreenPageMode	nfpmUseNone, nfpmUseOutlines, nfpmUseThumbs, nfpmUseOC, nfpmUseAttachments
PrintScaling	psNone, psAppDefault
Duplex	dupSimplex, dupDuplexFlipShortEdge, dupDuplexFlipLongEdge
PrintArea / PrintClip / ViewArea / ViewClip	pbMediaBox, pbCropBox, pbBleedBox, pbTrimBox, pbArtBox

InitialZoom-integrering

InitialZoom kompletterar ViewerPreferences genom att styra det initiala sidvisningsläget när dokumentet öppnas

Standard: Sedan HotPDF v2.3.11 är standardvärdet FitHeight (PDF-destination /FitV), så genererade dokument öppnas med varje sida anpassad till viewerfönstrets höjd. Sätt InitialZoom till FitNone för att utelämna OpenAction och låta viewern falla tillbaka till sin egen default zoom

// Fullständig konfiguration av dokumentpresentation
HotPDF.ViewerPreferences := [vpFitWindow, vpCenterWindow, vpDisplayDocTitle];
HotPDF.InitialZoom := FitWidth;

// Konfiguration för tekniskt dokument
HotPDF.ViewerPreferences := [vpDisplayDocTitle, vpPrintScaling];
HotPDF.InitialZoom := Zoom125;

// Presentationsläge
HotPDF.ViewerPreferences := [vpFitWindow, vpHideToolbar, vpHideMenubar];
HotPDF.InitialZoom := FitPage;

Implementeringsexempel

var
  VPref: THPDFViewerPreferences;
begin
  VPref := [vpFitWindow, vpCenterWindow, vpDisplayDocTitle];

  if EnableDirection then
  begin
    Include(VPref, vpDirection);
    HotPDF.Direction := RightToLeft;
  end;

  if EnablePrintScaling then
  begin
    Include(VPref, vpPrintScaling);
    HotPDF.PrintScaling := psNone;
  end;

  HotPDF.ViewerPreferences := VPref;
  HotPDF.InitialZoom := FitWidth;
end;

Kompatibilitetsanteckningar

Adobe Reader/Acrobat: Ger vanligtvis det mest kompletta stödet för ViewerPreferences
Andra viewers: Stödet varierar eftersom dessa värden är preferenser, inte hårda krav
Mjuk degradering: Inställningar som inte stöds bör ignoreras säkert av conforming viewers

Demoapplikationer

Följande demos är synkroniserade med det aktuella biblioteksstödet:

Demo\Delphi\ViewerPref
Demo\CBuilder\ViewerPref