ViewerPreferences komplet reference

ViewerPreferencesgiver dig mulighed for at styre, hvordan PDF-dokumenter præsenteres i understøttede visere, og hvordan nogle standardudskrivningsindstillinger initialiseres. Det aktuelle HotPDF-bibliotek understøtter 14 ViewerPreferences-værdier plus den relateredeInitialZoom property

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

Understøttede ViewerPreferences

Option	Ledsagende egenskab	Beskrivelse
vpHideToolbar	None	Skjul viserens værktøjslinje
vpHideMenubar	None	Skjul viserens menulinje
vpHideWindowUI	None	Skjul brugergrænsefladeelementer såsom rullepaneler og navigationskontroller
vpFitWindow	None	Tilpas dokumentvinduets størrelse til at passe til den første viste side
vpCenterWindow	None	Centrer dokumentvinduet på skærmen
vpDisplayDocTitle	Title	Vis dokumenttitlen i stedet for filnavnet i viserens overskrift
vpDirection	Direction	Gem den fremherskende læserækkefølge ved hjælp af`LeftToRight` or `RightToLeft`.
vpNonFullScreenPageMode	NonFullScreenPageMode	Vælg den sidetilstand, der skal bruges efter afslutning af fuldskærmstilstand
vpPrintScaling	PrintScaling	Choose `psNone` or `psAppDefault`til standardudskrivningsskalering
vpDuplex	Duplex	Vælg simpleks- eller dupleksudskrivningsadfærd
vpPickTrayByPDFSize	None	Anmod om valg af printerbakke baseret på PDF-sidestørrelsen
vpNumCopies	NumCopies	Gem det foreslåede antal udskriftskopier
vpPrintArea	PrintArea	Vælg den sidegrænse, der skal bruges til udskriftsrendering
vpPrintClip	PrintClip	Vælg den sidegrænse, der skal bruges til udskriftsklipning
vpViewArea	ViewArea	Sidegrænse brugt til visningsområdet på skærmen (PDF 1.4 12.2). Tilgængelig siden HotPDF v2.29.0
vpViewClip	ViewClip	Sidegrænse brugt til visningsklipning på skærmen (PDF 1.4 12.2). Tilgængelig siden HotPDF v2.29.0

Ledsagende egenskabsværdier

Disse egenskaber skrives kun, når det matchende ViewerPreferences-flag er aktiveret

Property	Values
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 integration

InitialZoomsupplerer ViewerPreferences ved at styre den indledende sidevisningstilstand, når dokumentet åbnes

StandardSiden HotPDF v2.3.11 har standardværdien væretFitHeight (PDF /FitVdestination), så genererede dokumenter åbnes med hver side tilpasset til viserens vindueshøjde. IndstilInitialZoom to FitNonefor at udelade OpenAction og lade viseren falde tilbage på 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;

Implementeringseksempel

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;

Kompatibilitetsnoter

Adobe Reader/Acrobat:Giver normalt den mest komplette ViewerPreferences-understøttelse
Andre visere:Understøttelsen varierer, fordi disse værdier er præferencer og ikke hårde krav
Graciøs nedbrydningUnderstøttede indstillinger bør ignoreres sikkert af overensstemmende visere

Demoprogrammer

De følgende demoer er synkroniseret med den aktuelle biblioteksunderstøttelse

Demo\Delphi\ViewerPref
Demo\CBuilder\ViewerPref