|
Riferimento completo di ViewerPreferences
ViewerPreferences ti permettono di controllare come i documenti PDF vengono presentati nei viewer che li supportano e come alcune impostazioni di stampa predefinite vengono inizializzate. L'attuale libreria HotPDF supporta 14 valori ViewerPreferences più il correlato InitialZoom property.
Tipi di dati correnti
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 supportati
| Option |
Proprietà companion |
Descrizione |
| vpHideToolbar |
None |
Nasconde la barra degli strumenti del viewer. |
| vpHideMenubar |
None |
Nasconde la barra dei menu del viewer. |
| vpHideWindowUI |
None |
Nasconde elementi UI come barre di scorrimento e controlli di navigazione. |
| vpFitWindow |
None |
Ridimensiona la finestra del documento per adattarla alla prima pagina mostrata. |
| vpCenterWindow |
None |
Centra la finestra del documento sullo schermo. |
| vpDisplayDocTitle |
Title |
Mostra il titolo del documento invece del nome del file nella didascalia del viewer. |
| vpDirection |
Direction |
Memorizza l'ordine di lettura predominante usando LeftToRight oppure RightToLeft. |
| vpNonFullScreenPageMode |
NonFullScreenPageMode |
Sceglie la modalità di pagina da usare dopo l'uscita da schermo intero. |
| vpPrintScaling |
PrintScaling |
Choose psNone oppure psAppDefault for default print scaling. |
| vpDuplex |
Duplex |
Sceglie il comportamento di stampa simplex o duplex. |
| vpPickTrayByPDFSize |
None |
Richiede la selezione del vassoio della stampante in base al formato pagina PDF. |
| vpNumCopies |
NumCopies |
Memorizza il numero di copie di stampa suggerito. |
| vpPrintArea |
PrintArea |
Seleziona il confine di pagina usato per il rendering di stampa. |
| vpPrintClip |
PrintClip |
Seleziona il confine di pagina usato per il clipping di stampa. |
| vpViewArea |
ViewArea |
Page boundary used for the on-screen view area (PDF 1.4 12.2). Available since HotPDF v2.29.0. |
| vpViewClip |
ViewClip |
Page boundary used for the on-screen view clipping (PDF 1.4 12.2). Available since HotPDF v2.29.0. |
Valori della proprietà companion
Queste proprietà vengono scritte solo quando il flag ViewerPreferences corrispondente è abilitato.
| Property |
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 |
Integrazione con InitialZoom
InitialZoom completa ViewerPreferences controllando la modalità di visualizzazione iniziale della pagina all'apertura del documento.
Predefinito: Dalla HotPDF v2.3.11 il valore predefinito è FitHeight (PDF /FitV ), così i documenti generati si aprono con ogni pagina adattata all'altezza della finestra del viewer. Imposta InitialZoom to FitNone to omit the OpenAction and let the viewer fall back to its own default zoom.
// Configurazione completa della presentazione del documento HotPDF.ViewerPreferences := [vpFitWindow, vpCenterWindow, vpDisplayDocTitle]; HotPDF.InitialZoom := FitWidth; // Configurazione documento tecnico HotPDF.ViewerPreferences := [vpDisplayDocTitle, vpPrintScaling]; HotPDF.InitialZoom := Zoom125; // Modalità presentazione HotPDF.ViewerPreferences := [vpFitWindow, vpHideToolbar, vpHideMenubar]; HotPDF.InitialZoom := FitPage;
Implementation Example
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 di compatibilità
- Adobe Reader/Acrobat: Di solito offre il supporto ViewerPreferences più completo.
- Altri viewer: Il supporto varia perché questi valori sono preferenze, non requisiti rigidi.
- Degrado graduale: Le impostazioni non supportate dovrebbero essere ignorate in sicurezza dai viewer conformi.
Applicazioni demo
Le seguenti demo sono sincronizzate con il supporto attuale della libreria:
- Demo\Delphi\ViewerPref
- Demo\CBuilder\ViewerPref
|