Volledige ViewerPreferences-referentie

ViewerPreferences laten u bepalen hoe PDF-documenten worden weergegeven in ondersteunde viewers en hoe sommige standaard afdrukinstellingen worden geïnitialiseerd. De huidige HotPDF-bibliotheek ondersteunt 14 ViewerPreferences-waarden plus de bijbehorende eigenschap InitialZoom

Huidige gegevenstypen

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;

Ondersteunde ViewerPreferences

Optie	Bijbehorende eigenschap	Beschrijving
vpHideToolbar	None	Verbergt de werkbalk van de viewer
vpHideMenubar	None	Verbergt de menubalk van de viewer
vpHideWindowUI	None	Verbergt UI-elementen zoals schuifbalken en navigatiebesturing
vpFitWindow	None	Past het documentvenster aan zodat de eerst weergegeven pagina past
vpCenterWindow	None	Centreert het documentvenster op het scherm
vpDisplayDocTitle	Title	Toont de documenttitel in plaats van de bestandsnaam in de titelbalk van de viewer
vpDirection	Direction	Legt de dominante leesvolgorde vast met `LeftToRight` of `RightToLeft`
vpNonFullScreenPageMode	NonFullScreenPageMode	Kiest de paginamodus die moet worden gebruikt nadat de volledig-schermmodus wordt verlaten
vpPrintScaling	PrintScaling	Kiest `psNone` of `psAppDefault` voor standaard afdrukschaal
vpDuplex	Duplex	Kiest simplex- of duplexafdrukgedrag
vpPickTrayByPDFSize	None	Vraagt printerlademeting aan op basis van het PDF-paginaformaat
vpNumCopies	NumCopies	Slaat het voorgestelde aantal afdrukexemplaren op
vpPrintArea	PrintArea	Selecteert de paginarand die wordt gebruikt voor afdrukweergave
vpPrintClip	PrintClip	Selecteert de paginarand die wordt gebruikt voor afdrukafsnijden
vpViewArea	ViewArea	Paginarand die wordt gebruikt voor het on-screen weergavegebied (PDF 1.4 12.2). Beschikbaar sinds HotPDF v2.29.0
vpViewClip	ViewClip	Paginarand die wordt gebruikt voor het on-screen weergave-afsnijden (PDF 1.4 12.2). Beschikbaar sinds HotPDF v2.29.0

Bijbehorende eigenschapswaarden

Deze eigenschappen worden alleen geschreven wanneer de bijbehorende ViewerPreferences-vlag is ingeschakeld

Eigenschap	Waarden
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-integratie

InitialZoom vult ViewerPreferences aan door de initiële paginaweergavemodus te bepalen wanneer het document wordt geopend

Standaard: Sinds HotPDF v2.3.11 is de standaardwaarde FitHeight (PDF /FitV-doel), zodat gegenereerde documenten openen met elke pagina passend op de vensterhoogte van de viewer. Stel InitialZoom in op FitNone om de OpenAction weg te laten en de viewer terug te laten vallen op zijn eigen standaardzoom

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

Implementatievoorbeeld

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;

Compatibiliteitsopmerkingen

Adobe Reader/Acrobat: Biedt meestal de meest volledige ondersteuning voor ViewerPreferences
Andere viewers: De ondersteuning varieert omdat deze waarden voorkeuren zijn, geen harde vereisten
Geleidelijke degradatie: Niet-ondersteunde instellingen moeten veilig worden genegeerd door conformerende viewers

Demotoepassingen

De volgende demo's zijn gesynchroniseerd met de huidige bibliotheekondersteuning:

Demo\Delphi\ViewerPref
Demo\CBuilder\ViewerPref