LinkOptions - TPdfView - PDFium Delphi Component

Componente: TPdfView · Unità: PDFium

Insieme pubblicato che controlla quali dei quattro tipi di azione link di PDFium la vista segue automaticamente quando l'utente fa clic sul collegamento

Syntax

property LinkOptions: TPdfViewLinkOptions;

Description

LinkOptions è un set of TPdfViewLinkOption Pascal. Ogni flag abilita/disabilita la gestione automatica di un tipo di azione link PDF:

loAutoGoto — salti nel documento (destinazioni nominate, azioni /GoTo / /GoToR verso se stesso). Quando attivo la vista porta PageNumber alla destinazione al clic
loAutoOpenURI — link web e URI esterni. Quando attivo la vista chiama ShellExecute sull' URI
loAutoLaunch — azioni "lancia un programma / apri un file su disco". Spento per sicurezza; un clic accidentale su un'azione launch malevola non deve eseguire un eseguibile arbitrario
loAutoEmbeddedGoto — riservato ai salti verso destinazioni nominate dentro un PDF incorporato diverso. Spento per predefinito

Il valore predefinito è [loAutoGoto, loAutoOpenURI] — salti di pagina sicuri e aperture di URL restano automatici, mentre il lancio di programmi e i salti tra documenti richiedono che l'applicazione acconsenta esplicitamente

Ogni azione link solleva anche l'evento corrispondente OnAnnotationLinkClick (annotazioni /Link con annotazione) o OnWebLinkClick (risultati dello scanner dei link web) PRIMA che parta il gestore automatico. Marca il parametro Handled dell'evento a True per sopprimere l'azione automatica, oppure reindirizza il link attraverso una conferma / policy di sicurezza / log di audit

Remarks

Il rilevamento del clic sui link parte solo quando il gesto è un clic e non un trascinamento, usando un ancoraggio MouseDown fresco così i gesti di pan continuano a fluire nel percorso di scroll esistente senza cambiamenti
Imposta i predefiniti a design time nell'Object Inspector o assegnali a runtime prima di Active := True; LinkOptions è published
Disabilitare loAutoOpenURI è la scelta sicura per l'incorporamento in un chiosco o in un viewer di documenti non fidati — abbinalo a OnWebLinkClick che verifichi l'URL prima di fare qualsiasi cosa
Il percorso "auto" apre il link sulla STESSA pagina che la vista sta mostrando, anche quando il TPdf sottostante è fermo su una pagina diversa (correzione della 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 Proprietà

Componente: TPdfView · Unità: PDFium

Syntax

Description

Remarks

Example

See Also