LinkOptions - TPdfView - PDFium Delphi Component

Komponente: TPdfView · Unit: PDFium

Veröffentlichtes Set, das steuert, welchen der vier Linkaktionstypen von PDFium der Viewer beim Klicken auf den Link automatisch folgt

Syntax

property LinkOptions: TPdfViewLinkOptions;

Description

LinkOptions ist ein Pascal-set of TPdfViewLinkOption. Jedes Flag schaltet die automatische Behandlung eines PDF-Link-Aktionstyps um:

loAutoGoto — Sprünge im Dokument (named destinations, /GoTo- / /GoToR-to-self-Aktionen). Ist es gesetzt, navigiert die View PageNumber bei einem Klick zum Ziel
loAutoOpenURI — Web-Links und externe URIs. Ist es gesetzt, ruft die View ShellExecute auf die URI auf
loAutoLaunch — "Programm starten / Datei auf der Platte öffnen"-Aktionen. Sicherheitshalber aus; ein Fehlklick auf eine bösartige Launch-Aktion soll kein beliebiges Executable starten
loAutoEmbeddedGoto — reserviert für Sprünge zu named destinations in einem anderen eingebetteten PDF. Standardmäßig aus

Der Standardwert ist [loAutoGoto, loAutoOpenURI] — ungefährliche Seitensprünge und URL-Aufrufe bleiben automatisch, während Programmaufrufe und dokumentübergreifende Sprünge eine ausdrückliche Zustimmung der Anwendung verlangen

Jede Link-Aktion löst zusätzlich das passende OnAnnotationLinkClick- (annotierte /Link-Annotationen) oder OnWebLinkClick-Ereignis (Treffer des Web-Link-Scanners) AUS, BEVOR der automatische Handler läuft. Den Handled- Parameter des Ereignisses auf True setzen, um die Auto-Aktion zu unterdrücken, oder den Link über einen Bestätigungsdialog / eine Sicherheitsrichtlinie / ein Audit-Log umleiten

Remarks

Die Link-Klick-Erkennung greift nur, wenn die Geste ein Klick statt eines Ziehens ist, und nimmt dafür einen frischen MouseDown-Anker, sodass Schwenk-Gesten weiterhin unverändert durch den bestehenden Scroll-Pfad laufen
Design-Time-Standards im Object Inspector setzen oder zur Laufzeit zuweisen, bevor Active := True ist; LinkOptions ist published
Das Abschalten von loAutoOpenURI ist die sichere Wahl für den Einbau in einen Kiosk- oder Viewer für nicht vertrauenswürdige Dokumente — mit einem OnWebLinkClick kombinieren, das die URL prüft, bevor irgendetwas passiert
Der "Auto"-Pfad öffnet den Link auf der SELBEN Seite, die der Viewer gerade zeigt, selbst wenn das zugrunde liegende TPdf auf einer anderen Seite steht (Fix aus v1.16.1)

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 Eigenschaft

Komponente: TPdfView · Unit: PDFium

Syntax

Description

Remarks

Example

See Also