LinkOptions - TPdfView

Component: TPdfView · Unit: PDFium

Publisert sett som styrer hvilke av PDFiums fire lenkehandlingstyper viseren følger automatisk når brukeren klikker på lenken

Syntax

property LinkOptions: TPdfViewLinkOptions;

Description

LinkOptions er et Pascal-set of TPdfViewLinkOption. Hvert flagg styrer automatisk håndtering av én PDF-lenkeshandlingstype:

loAutoGoto — hopp innen dokumentet (navngitte destinasjoner, /GoTo- og /GoToR-til-seg-handlinger). Når flagget er satt, navigerer visningen PageNumber til destinasjonen ved klikk
loAutoOpenURI — weblenker og eksterne URI-er. Når flagget er satt, kaller visernen ShellExecute på URI-en
loAutoLaunch — handlinger av typen «start et program / åpne en fil på disken». Av som standard av sikkerhetshensyn; et tilfeldig klikk på en ondsinnet launch-handling skal ikke kjøre et vilkårlig kjørbart program
loAutoEmbeddedGoto — reservert for hopp til navngitte destinasjoner inne i en annen innebygd PDF. Av som standard

Standardverdien er [loAutoGoto, loAutoOpenURI] — trygge sidehopp og URL-åpninger forblir automatiske, mens programstart og dokumentkryssende hopp krever at programmet melder seg på eksplisitt

Hver lenkehandling utløser også den tilsvarende OnAnnotationLinkClick- (annoterte /Link-merknader) eller OnWebLinkClick-hendelsen (treff fra weblenkescanneren) FØR den automatiske behandleren kjører. Sett hendelsens Handled- parameter til True for å undertrykke auto-handlingen, eller omdiriger lenken gjennom en bekreftelsesdialog / sikkerhetspolicy / revisjonslogg

Remarks

Klikkdeteksjon for lenker kjører bare når gesten er et klikk snarere enn en draoperasjon, med et ferskt MouseDown-anker, slik at panoreringsgester fortsatt flyter uendret gjennom den eksisterende rullestien
Sett standardverdier for designtid i Object Inspector, eller tilordne ved kjøretid før Active := True; LinkOptions er publisert
Å deaktivere loAutoOpenURI er det trygge valget for innebygging i en kiosk eller en viser for ikke-klarerte dokumenter — kombiner det med OnWebLinkClick som kontrollerer URL-en før noe som helst gjøres
«auto»-banen åpner lenken på SAMME siden som viseren viser akkurat nå, selv når den underliggende TPdf-en står på en annen side (v1.16.1-fiks)

Example

// Safe defaults: auto-follow only in-doc jumps and URIs
PdfView1.LinkOptions := [loAutoGoto, loAutoOpenURI];

// Vet URI clicks before opening
procedure TForm1.PdfView1WebLinkClick(Sender: TObject;
  WebLinkIndex: Integer; const Url: WString;
  var Handled: Boolean);
begin
  if MessageDlg('Open ' + Url + '?',
    mtConfirmation, [mbYes, mbNo], 0) <> mrYes then
    Handled := True; // suppress auto-handling
end;

LinkOptions-egenskap

Component: TPdfView · Unit: PDFium

Syntax

Description

Remarks

Example

See Also