ViewerPreferences Complete Reference

ViewerPreferences-asetusten avulla voit ohjata, miten PDF-dokumentit esitetään niitä tukevissa katseluohjelmissa ja miten jotkin oletustulostusasetukset alustetaan. Nykyinen HotPDF-kirjasto tukee 14 ViewerPreferences-arvoa sekä niihin liittyvää InitialZoom-ominaisuutta

Current Data Types

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;

Supported ViewerPreferences

Option	Companion-ominaisuus	Kuvaus
vpHideToolbar	None	Piilota katseluohjelman työkalupalkki
vpHideMenubar	None	Piilota katseluohjelman valikkopalkki
vpHideWindowUI	None	Piilota käyttöliittymäelementit, kuten vierityspalkit ja navigointiohjaimet
vpFitWindow	None	Muuta asiakirjaikkunan kokoa siten, että se sopii ensimmäiseen näytettävään sivuun
vpCenterWindow	None	Keskitä dokumentin ikkuna näytölle
vpDisplayDocTitle	Title	Näytä dokumentin otsikko tiedostonimen sijaan katseluohjelman otsikkorivillä
vpDirection	Direction	Tallentaa pääasiallisen lukujärjestyksen käyttämällä arvoa `LeftToRight` tai `RightToLeft`
vpNonFullScreenPageMode	NonFullScreenPageMode	Valitse sivutila, jota käytetään koko näytön tilasta poistumisen jälkeen
vpPrintScaling	PrintScaling	Choose `psNone` or `psAppDefault` for default print scaling
vpDuplex	Duplex	Valitse simplex- tai duplex-tulostuskäyttäytyminen
vpPickTrayByPDFSize	None	Pyydä tulostimen paperilokeron valintaa PDF-sivukoon perusteella
vpNumCopies	NumCopies	Tallentaa ehdotetun tulostuskopioiden määrän
vpPrintArea	PrintArea	Valitsee tulostuksen piirtämiseen käytettävän sivurajan
vpPrintClip	PrintClip	Valitsee tulostuksen rajaukseen käytettävän sivurajan
vpViewArea	ViewArea	Sivun rajaus, jota käytetään näytettävälle katselualueelle (PDF 1.4 12.2). Saatavilla versiosta HotPDF v2.29.0 alkaen
vpViewClip	ViewClip	Sivun rajaus, jota käytetään näytettävän katselualueelle leikkaukseen (PDF 1.4 12.2). Saatavilla versiosta HotPDF v2.29.0 alkaen

Companion Property Values

Nämä ominaisuudet kirjoitetaan vain, kun vastaava ViewerPreferences-lippu on käytössä

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

InitialZoom täydentää ViewerPreferences-asetuksia ohjaamalla sivun alustavaa näyttötilaa, kun dokumentti avataan

Oletusarvo: Versiosta HotPDF v2.3.11 lähtien oletusarvo on FitHeight (PDF:n /FitV-kohde), joten luodut dokumentit avautuvat siten, että jokainen sivu sovitetaan katseluohjelman ikkunan korkeuteen. Aseta InitialZoom arvoon FitNone jättääksesi OpenAction-toiminnon pois ja antaaksesi katseluohjelman käyttää omaa oletussuurennostaan

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

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;

Compatibility Notes

Adobe Reader/Acrobat: Tarjoaa yleensä kattavimman ViewerPreferences-tuen
Muut katseluohjelmat: Tuki vaihtelee, koska nämä arvot ovat asetuksia, eivät tiukkoja vaatimuksia
Hienovaraisen heikkenemisen periaate: Yhteensopivien katseluohjelmien tulisi ohittaa turvallisesti tukemattomat asetukset

Demo Applications

Seuraavat demot on synkronoitu kirjaston nykyisen tuen kanssa

Demo\Delphi\ViewerPref
Demo\CBuilder\ViewerPref