LinkOptions - TPdfView - PDFium Delphi Component

Component: TPdfView · Unit: PDFium

Opublikowany zestaw, który kontroluje, które z czterech typów akcji łączy PDFium widok śledzi automatycznie, gdy użytkownik kliknie łącze

Syntax

property LinkOptions: TPdfViewLinkOptions;

Description

LinkOptions to pascalowy set of TPdfViewLinkOption. Każda flaga przełącza automatyczną obsługę jednego typu akcji łącza PDF:

loAutoGoto — przeskoki wewnątrz dokumentu (nazwane miejsca docelowe, akcje /GoTo / /GoToR do własnego dokumentu). Gdy flaga jest ustawiona, widok po kliknięciu nawiguje PageNumber do miejsca docelowego
loAutoOpenURI — łącza sieciowe i zewnętrzne URI. Gdy flaga jest ustawiona, widok wywołuje ShellExecute na URI
loAutoLaunch — akcje typu „uruchom program / otwórz plik na dysku". Domyślnie wyłączona ze względów bezpieczeństwa; przypadkowe kliknięcie złośliwej akcji uruchomienia nie powinno wykonywać dowolnego pliku wykonywalnego
loAutoEmbeddedGoto — zarezerwowane dla przeskoków do nazwanych miejsc docelowych wewnątrz innego osadzonego PDF. Domyślnie wyłączone

Wartością domyślną jest [loAutoGoto, loAutoOpenURI] — bezpieczne przeskoki stron i otwieranie adresów URL pozostają automatyczne, natomiast uruchamianie programów i przeskoki między dokumentami wymagają jawnego włączenia przez aplikację

Każda akcja łącza wywołuje także odpowiednie zdarzenie OnAnnotationLinkClick (adnotacje /Link) albo OnWebLinkClick (trafienia skanera łączy sieciowych), zanim uruchomi się automatyczna obsługa. Oznacz parametr Handled zdarzenia jako True, aby stłumić automatyczną akcję, albo przekieruj łącze przez monit potwierdzenia / politykę bezpieczeństwa / dziennik audytu

Remarks

Wykrywanie kliknięć łączy działa tylko wtedy, gdy gest jest kliknięciem, a nie przeciąganiem, przy użyciu świeżej kotwicy MouseDown, więc gesty przesuwania nadal przepływają przez istniejącą ścieżkę przewijania bez zmian
Ustaw domyślne wartości czasu projektowania w Object Inspector albo przypisz w czasie wykonywania przed Active := True; LinkOptions jest publikowane
Wyłączenie loAutoOpenURI to bezpieczny wybór przy osadzaniu w kiosku albo przeglądarce niezaufanych dokumentów — połącz je z OnWebLinkClick, które weryfikuje adres URL, zanim cokolwiek zrobi
Ścieżka „auto" otwiera łącze na TEJ SAMEJ stronie, którą przeglądarka aktualnie pokazuje, nawet gdy bazowy TPdf jest zaparkowany na innej stronie (poprawka 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 Właściwość

Component: TPdfView · Unit: PDFium

Syntax

Description

Remarks

Example

See Also