Referință completă pentru ViewerPreferences

ViewerPreferences vă permit să controlați modul în care documentele PDF sunt prezentate în viewer-ele compatibile și modul în care sunt inițializate unele setări implicite de imprimare. Biblioteca HotPDF actuală acceptă 14 valori ViewerPreferences plus proprietatea asociată InitialZoom

Tipuri de date curente

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 acceptate

Opțiune	Proprietate asociată	Descriere
vpHideToolbar	None	Ascunde bara de instrumente a viewerului
vpHideMenubar	None	Ascunde bara de meniu a viewerului
vpHideWindowUI	None	Ascunde elemente de interfață precum barele de derulare și controalele de navigare
vpFitWindow	None	Redimensionează fereastra documentului pentru a se potrivi primei pagini afișate
vpCenterWindow	None	Centrează fereastra documentului pe ecran
vpDisplayDocTitle	Title	Afișează titlul documentului în locul numelui fișierului în bara de titlu a viewerului
vpDirection	Direction	Stochează ordinea predominantă de citire folosind `LeftToRight` sau `RightToLeft`
vpNonFullScreenPageMode	NonFullScreenPageMode	Alege modul de pagină folosit după ieșirea din modul ecran complet
vpPrintScaling	PrintScaling	Alege `psNone` sau `psAppDefault` pentru scalarea implicită la imprimare
vpDuplex	Duplex	Alege comportamentul de imprimare simplex sau duplex
vpPickTrayByPDFSize	None	Cere selectarea tăvii imprimantei în funcție de dimensiunea paginii PDF
vpNumCopies	NumCopies	Stochează numărul sugerat de copii pentru imprimare
vpPrintArea	PrintArea	Selectează limita paginii folosită pentru randarea la imprimare
vpPrintClip	PrintClip	Selectează limita paginii folosită pentru decuparea la imprimare
vpViewArea	ViewArea	Limita paginii folosită pentru zona de vizualizare pe ecran (PDF 1.4 12.2). Disponibilă din HotPDF v2.29.0
vpViewClip	ViewClip	Limita paginii folosită pentru decuparea vizualizării pe ecran (PDF 1.4 12.2). Disponibilă din HotPDF v2.29.0

Valori ale proprietății asociate

Aceste proprietăți sunt scrise numai când indicatorul ViewerPreferences corespunzător este activat

Proprietate	Valori
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

Integrarea InitialZoom

InitialZoom completează ViewerPreferences prin controlul modului inițial de afișare a paginii când documentul este deschis

Implicit: Din HotPDF v2.3.11 valoarea implicită este FitHeight (destinația PDF /FitV), astfel încât documentele generate se deschid cu fiecare pagină încadrată la înălțimea ferestrei viewerului. Setați InitialZoom la FitNone pentru a omite OpenAction și a lăsa viewerul să revină la propriul zoom implicit

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

Exemplu de implementare

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;

Note de compatibilitate

Adobe Reader/Acrobat: De obicei oferă cel mai complet suport pentru ViewerPreferences
Alte programe de vizualizare: Suportul variază deoarece aceste valori sunt preferințe, nu cerințe stricte
Degradare controlată: Setările neacceptate ar trebui ignorate în siguranță de viewer-ele conforme

Aplicații demo

Următoarele demo-uri sunt sincronizate cu suportul actual al bibliotecii:

Demo\Delphi\ViewerPref
Demo\CBuilder\ViewerPref