LinkOptions - TPdfView

Component: TPdfView · Unit: PDFium

Gepubliceerde verzameling die bepaalt welke van de vier linkactietypes van PDFium de weergave automatisch volgt wanneer de gebruiker op de link klikt

Syntax

property LinkOptions: TPdfViewLinkOptions;

Description

LinkOptions is een Pascal set of TPdfViewLinkOption. Elke vlag schakelt automatische afhandeling van één PDF-linkactietype in:

loAutoGoto — springs binnen het document (benoemde bestemmingen, /GoTo / /GoToR-to-self-acties). Wanneer ingesteld navigeert de weergave PageNumber naar de bestemming bij klikken.
loAutoOpenURI — weblinks en externe URI's. Wanneer ingesteld roept de weergave ShellExecute aan op de URI.
loAutoLaunch — "start een programma / open een bestand op schijf"-acties. Standaard uit voor veiligheid; een verdwaalde klik op een kwaadaardige startactie mag geen willekeurig uitvoerbaar bestand draaien.
loAutoEmbeddedGoto — gereserveerd voor sprongen naar benoemde bestemmingen binnen een andere ingebedde PDF. Standaard uit.

De standaardwaarde is [loAutoGoto, loAutoOpenURI] — veilige paginasprongen en URL-opens blijven automatisch, terwijl programma-start en cross-document-sprongen vereisen dat de toepassing zich expliciet aanmeldt.

Elke linkactie genereert ook de overeenkomstige OnAnnotationLinkClick- (geannoteerde /Link-annotaties) of OnWebLinkClick- (weblink-scanner-treffers) gebeurtenis VOORDAT de automatische afhandelingsroutine draait. Markeer de parameter Handled van de gebeurtenis als True om de auto-actie te onderdrukken, of leid de link om via een bevestigingsprompt / beveiligingsbeleid / auditlog.

Remarks

Linkklik-detectie draait alleen wanneer het gebaar een klik is in plaats van een sleep, met een verse MouseDown-anker zodat pan-gebaren nog ongewijzigd door het bestaande schuifpad lopen.
Stel standaardwaarden voor het ontwerp in via de Object Inspector of wijs ze tijdens runtime toe vóór Active := True; LinkOptions is gepubliceerd.
Het uitschakelen van loAutoOpenURI is de veilige keuze voor inbedding in een kiosk- of niet-vertrouwde-document-viewer — combineer het met OnWebLinkClick die de URL toetst voordat er iets wordt gedaan.
Het "auto"-pad opent de link op DEZELFDE pagina die de viewer momenteel toont, zelfs wanneer de onderliggende TPdf op een andere pagina staat (v1.16.1-fix).

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 eigenschap

Component: TPdfView · Unit: PDFium

Syntax

Description

Remarks

Example

See Also