LinkOptions - TPdfView

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.

Component: TPdfView · Unit: PDFium

Published set that controls which of PDFium's four link action types the view follows automatically when the user clicks the link.

Syntaxis

property LinkOptions: TPdfViewLinkOptions;

Beschrijving

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

loAutoGoto — sprongen binnen het document (genoemde bestemmingen, /GoTo / /GoToR-to-self-acties). Wanneer dit is ingesteld navigeert de view PageNumber bij klikken naar de bestemming
loAutoOpenURI — webkoppelingen en externe URI's. Wanneer dit is ingesteld roept de view ShellExecute aan op de URI
loAutoLaunch — acties voor "een programma starten / een bestand op schijf openen". Standaard uit voor de veiligheid; een losse klik op een kwaadaardige startactie mag geen willekeurige executable uitvoeren
loAutoEmbeddedGoto — gereserveerd voor sprongen naar genoemde bestemmingen in een andere ingebedde PDF. Standaard uit

De standaardwaarde is [loAutoGoto, loAutoOpenURI] — veilige paginasprongen en het openen van URL's blijven automatisch, terwijl programmasprongen en sprongen tussen documenten alleen werken als de toepassing daar expliciet voor kiest

Elke linkactie roept ook het bijbehorende OnAnnotationLinkClick-event (geannoteerde /Link-annotaties) of OnWebLinkClick-event (treffers van de web-linkscanner) AAN VOORDAT de automatische handler draait. Zet de Handled-parameter van het event op True om de automatische actie te onderdrukken, of leid de link via een bevestigingsdialoog / beveiligingsbeleid / auditlog.

Opmerkingen

Detectie van linkklikken werkt alleen wanneer het gebaar een klik is en geen sleepactie, met een verse MouseDown-ankerpunt zodat pangebaren nog steeds onveranderd via het bestaande scrollpad lopen
Stel ontwerp-tijdstandaarden in via de Object Inspector of wijs ze tijdens runtime toe vóór Active := True; LinkOptions is gepubliceerd
loAutoOpenURI uitschakelen is de veilige keuze voor insluiten in een kiosk of viewer voor niet-vertrouwde documenten — combineer dit met OnWebLinkClick dat de URL controleert voordat iets gebeurt
Het "auto"-pad opent de link op dezelfde pagina die de viewer op dat moment toont, zelfs wanneer de onderliggende TPdf op een andere pagina staat (v1.16.1-fix)

Voorbeeld

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

Zie ook

OnAnnotationLinkClick, OnWebLinkClick, WebLinkAtPos, LinkAnnotationAtPos