LinkOptions - TPdfView

Ten wpis API zachowuje identyfikatory, sygnatury, bloki kodu i terminy PDF w oryginalnej postaci.

Komponent: TPdfView · Moduł: PDFium

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

Składnia

property LinkOptions: TPdfViewLinkOptions;

Opis

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

loAutoGoto — skoki wewnątrz dokumentu, takie jak nazwane destynacje oraz akcje /GoTo / /GoToR-to-self. Gdy ta opcja jest ustawiona, widok nawiguje PageNumber do celu po kliknięciu
loAutoOpenURI — łącza WWW i zewnętrzne URI. Gdy ta opcja jest ustawiona, widok wywołuje ShellExecute dla URI
loAutoLaunch — akcje „uruchom program / otwórz plik z dysku”. Domyślnie Off ze względów bezpieczeństwa; przypadkowe kliknięcie złośliwej akcji uruchomienia nie powinno startować dowolnego pliku wykonywalnego
loAutoEmbeddedGoto — zarezerwowane dla skoków do nazwanych destynacji wewnątrz innego osadzonego PDF. Domyślnie wyłączone

Wartość domyślna to [loAutoGoto, loAutoOpenURI] — bezpieczne skoki po stronach i otwieranie URL pozostają automatyczne, natomiast uruchamianie programów i skoki między dokumentami wymagają wyraźnego włączenia przez aplikację

Każda akcja łącza wyzwala też odpowiednie OnAnnotationLinkClick (adnotowane adnotacje /Link) albo OnWebLinkClick (trafienia skanera łączy WWW) PRZED uruchomieniem automatycznego handlera. Ustaw parametr Handled zdarzenia na True, aby wyłączyć akcję automatyczną, albo przekieruj łącze przez potwierdzenie / politykę bezpieczeństwa / dziennik audytu

Uwagi

Wykrywanie kliknięcia łącza działa tylko wtedy, gdy gest jest kliknięciem, a nie przeciągnięciem, korzystając ze świeżego punktu zaczepienia MouseDown, dzięki czemu gesty przesuwania nadal przechodzą przez istniejącą ścieżkę przewijania bez zmian
Ustaw domyślne wartości czasu projektowania w Object Inspector albo przypisz je w czasie działania przed Active := True; LinkOptions jest publikowane
Wyłączenie loAutoOpenURI to bezpieczny wybór przy osadzaniu w kiosku albo w widoku niezaufanych dokumentów — połącz go z OnWebLinkClick, który sprawdza URL przed wykonaniem czegokolwiek
Ścieżka „auto” otwiera łącze na TYM SAMYM arkuszu, który widok właśnie pokazuje, nawet gdy podstawowy TPdf znajduje się na innej stronie (poprawka v1.16.1)

Przykład

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

Zobacz też

OnAnnotationLinkClick, OnWebLinkClick, WebLinkAtPos, LinkAnnotationAtPos