ViewerPreferences Complete Reference

Full referanse for ViewerPreferences

ViewerPreferences lar deg styre hvordan PDF-dokumenter vises i støttede visere og hvordan enkelte standardinnstillinger for utskrift initialiseres. Det gjeldende HotPDF-biblioteket støtter 14 ViewerPreferences-verdier pluss den tilhørende egenskapen InitialZoom

Gjeldende 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;

Støttede ViewerPreferences

Option	Tilhørende egenskap	Beskrivelse
vpHideToolbar	None	Skjul verktøylinjen i viseren
vpHideMenubar	None	Skjul menylinjen i viseren
vpHideWindowUI	None	Skjul brukergrenselementer som rullefelt og navigasjonskontroller
vpFitWindow	None	Tilpass dokumentvinduet til den første viste siden
vpCenterWindow	None	Plasser dokumentvinduet midt på skjermen
vpDisplayDocTitle	Title	Vis dokumenttittelen i stedet for filnavnet i viserkapittelet
vpDirection	Direction	Lagre den dominerende leseretningen med `LeftToRight` eller `RightToLeft`
vpNonFullScreenPageMode	NonFullScreenPageMode	Velg sidemodusen som skal brukes etter at fullskjermmodus avsluttes
vpPrintScaling	PrintScaling	Velg `psNone` eller `psAppDefault` for standard utskriftsskalering
vpDuplex	Duplex	Velg enkeltsidig eller tosidig utskriftsatferd
vpPickTrayByPDFSize	None	Be om valg av skriverbrett basert på PDF-sidestørrelsen
vpNumCopies	NumCopies	Lagre foreslått antall utskriftskopier
vpPrintArea	PrintArea	Velg sidegrensen som brukes for utskriftsgjengivelse
vpPrintClip	PrintClip	Velg sidegrensen som brukes for utskriftsklipping
vpViewArea	ViewArea	Sidegrense som brukes for visningsområdet på skjermen (PDF 1.4 12.2). Tilgjengelig siden HotPDF v2.29.0
vpViewClip	ViewClip	Sidegrense som brukes for klipping i skjermvisningen (PDF 1.4 12.2). Tilgjengelig siden HotPDF v2.29.0

Verdier for tilhørende egenskaper

Disse egenskapene skrives bare når det tilhørende ViewerPreferences-flagget er aktivert

Egenskap	Verdier
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

Integrasjon av InitialZoom

InitialZoom utfyller ViewerPreferences ved å styre den innledende visningsmodusen for siden når dokumentet åpnes

Standard: Siden HotPDF v2.3.11 er standardverdien FitHeight (PDF /FitV-destinasjon), slik at genererte dokumenter åpnes med hver side tilpasset høyden på viservinduet. Sett InitialZoom til FitNone for å utelate OpenAction og la viseren falle tilbake til sin egen standardzoom

// Complete document presentation setup
HotPDF.ViewerPreferences := [vpFitWindow, vpCenterWindow, vpDisplayDocTitle];
HotPDF.InitialZoom := FitWidth;

// Technical document setup
HotPDF.ViewerPreferences := [vpDisplayDocTitle, vpPrintScaling];
HotPDF.InitialZoom := Zoom125;

// Presentation mode
HotPDF.ViewerPreferences := [vpFitWindow, vpHideToolbar, vpHideMenubar];
HotPDF.InitialZoom := FitPage;

Implementasjonseksempel

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;

Kompatibilitetsnotater

Adobe Reader/Acrobat: Gir vanligvis den mest komplette støtten for ViewerPreferences
Andre visere: Støtten varierer fordi disse verdiene er preferanser, ikke harde krav
Skånsom degradering: Ustøttede innstillinger bør ignoreres trygt av visere som følger spesifikasjonen

Demoprogrammer

Følgende demoer er synkronisert med gjeldende biblioteksstøtte

Demo\Delphi\ViewerPref
Demo\CBuilder\ViewerPref