LinkOptions - TPdfView - PDFium Delphi Component

Компонент: TPdfView · Модул: PDFium

Published множество, което контролира кои от четирите типа link actions на PDFium изгледът следва автоматично, когато потребителят кликне върху линка

Синтаксис

property LinkOptions: TPdfViewLinkOptions;

Описание

LinkOptions е Pascal set of TPdfViewLinkOption. Всеки флаг превключва автоматичното обработване на един тип PDF link action:

loAutoGoto — скокове в документа (именовани дестинации, /GoTo / /GoToR-to-self действия). Когато е зададен, изгледът навигира PageNumber към дестинацията при клик.
loAutoOpenURI — уеб линкове и външни URI-та. Когато е зададен, изгледът извиква ShellExecute върху URI-то.
loAutoLaunch — действия "стартирай програма / отвори файл на диска". Изключено по подразбиране от съображения за безопасност; случайният клик върху злонамерено launch действие не трябва да стартира произволен изпълним файл.
loAutoEmbeddedGoto — резервирано за скокове към именовани дестинации вътре в друг вграден PDF. Изключено по подразбиране.

Стойността по подразбиране е [loAutoGoto, loAutoOpenURI] — безопасните скокове на страници и отваряния на URL остават автоматични, докато стартирането на програми и скоковете между документи изискват приложението да се включи изрично.

Всяко link action също така вдига съответното OnAnnotationLinkClick (анотиращи /Link анотации) или OnWebLinkClick (web-link scanner попадения) събитие ПРЕДИ автоматичният handler да се изпълни. Маркирайте параметъра Handled на събитието като True, за да потиснете auto-action, или пренасочете линка през prompt за потвърждение / политика за сигурност / audit log.

Забележки

Детекцията на клик върху линк работи само когато жестът е клик, а не влачене, използвайки нов MouseDown anchor, така че жестовете за панорамиране все още преминават през съществуващия scroll път непроменени.
Задавайте стойности по подразбиране за design-time в Object Inspector или присвоявайте по време на изпълнение преди Active := True; LinkOptions е published.
Изключването на loAutoOpenURI е безопасният избор за вграждане в kiosk или прегледач на недоверени документи — комбинирайте го с OnWebLinkClick, който проверява URL-то, преди да направи каквото и да е.
"Auto" пътят отваря линка на СЪЩАТА страница, която прегледачът показва в момента, дори когато подлежащият TPdf е паркиран на различна страница (v1.16.1 поправка).

Пример

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

Виж също

OnAnnotationLinkClick, OnWebLinkClick, WebLinkAtPos, LinkAnnotationAtPos