LinkOptions - TPdfView

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.

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;

Beschreibung

LinkOptions ist ein Pascal-set of TPdfViewLinkOption. Jede Flagge schaltet die automatische Behandlung eines PDF-Linkaktionstyps ein oder aus

loAutoGoto — Sprünge innerhalb des Dokuments (benannte Ziele, /GoTo / /GoToR-to-self-Aktionen). Wenn gesetzt, navigiert der Viewer bei einem Klick die PageNumber zum Ziel
loAutoOpenURI — Weblinks und externe URIs. Wenn gesetzt, ruft der Viewer auf der URI ShellExecute auf
loAutoLaunch — Aktionen zum "Programm starten / Datei auf Datenträger öffnen". Aus Sicherheitsgründen standardmäßig aus; ein versehentlicher Klick auf eine bösartige Startaktion sollte kein beliebiges Programm ausführen
loAutoEmbeddedGoto — reserviert für Sprünge zu benannten Zielen in einem anderen eingebetteten PDF. Standardmäßig aus

Der Standardwert ist [loAutoGoto, loAutoOpenURI] — sichere Seitensprünge und URL-Öffnungen bleiben automatisch, während Programmstart- und dokumentübergreifende Sprünge eine explizite Zustimmung der Anwendung erfordern

Jede Linkaktion löst außerdem das entsprechende OnAnnotationLinkClick-Ereignis (annotierte /Link-Anmerkungen) oder OnWebLinkClick-Ereignis (Treffer des Weblink-Scanners) vor dem automatischen Handler aus. Setzen Sie den Parameter Handled des Ereignisses auf True, um die Autoaktion zu unterdrücken, oder leiten Sie den Link über eine Bestätigungsabfrage, Sicherheitsrichtlinie oder ein Auditprotokoll um

Hinweise

Die Link-Klick-Erkennung läuft nur, wenn die Geste ein Klick und kein Ziehen ist; dazu wird ein frischer MouseDown-Anker verwendet, damit Schwenkgesten weiter unverändert durch den vorhandenen Scrollpfad laufen
Setzen Sie Standardwerte zur Entwurfszeit im Objektinspektor oder weisen Sie sie zur Laufzeit zu, bevor Active := True; LinkOptions ist published
Das Deaktivieren von loAutoOpenURI ist die sichere Wahl für Einbettungen in Kiosk- oder nicht vertrauenswürdige Dokument-Viewer — kombinieren Sie es mit OnWebLinkClick, das die URL vor jeder Aktion prüft
Der "Auto"-Pfad öffnet den Link auf derselben Seite, die der Viewer gerade anzeigt, selbst wenn die zugrunde liegende TPdf auf einer anderen Seite geparkt ist (v1.16.1-Fix)

Beispiel

// Sichere Standardwerte: nur Sprünge im Dokument und URIs automatisch folgen
PdfView1.LinkOptions := [loAutoGoto, loAutoOpenURI];

// URI-Klicks vor dem Öffnen prüfen
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; // Auto-Behandlung unterdrücken
end;

Siehe auch

OnAnnotationLinkClick, OnWebLinkClick, WebLinkAtPos, LinkAnnotationAtPos