LinkOptions property

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.

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

LinkOptions is a Pascal set of TPdfViewLinkOption. Each flag toggles automatic handling of one PDF link action type:

• loAutoGoto — in-document jumps (named destinations, /GoTo / /GoToR-to-self actions). When set the view navigates PageNumber to the destination on click.
• loAutoOpenURI — web links and external URIs. When set the view calls ShellExecute on the URI.
• loAutoLaunch — "launch a program / open a file on disk" actions. Off by default for safety; a stray click on a malicious launch action should not run an arbitrary executable.
• loAutoEmbeddedGoto — reserved for jumps to named destinations inside another embedded PDF. Off by default.

The default value is [loAutoGoto, loAutoOpenURI] — safe page jumps and URL opens stay automatic, while program-launch and cross-document jumps require the application to opt in explicitly.

Each link action also raises the corresponding OnAnnotationLinkClick (annotated /Link annotations) or OnWebLinkClick (web-link scanner hits) event BEFORE the automatic handler runs. Mark the event's Handled parameter as True to suppress the auto-action, or redirect the link through a confirmation prompt / security policy / audit log.

• Link click detection runs only when the gesture is a click rather than a drag, using a fresh MouseDown anchor so panning gestures still flow through the existing scroll path unchanged.
• Set design-time defaults in the Object Inspector or assign at runtime before Active := True; LinkOptions is published.
• Disabling loAutoOpenURI is the safe choice for embedding in a kiosk or untrusted-document viewer — pair it with OnWebLinkClick that vets the URL before doing anything.
• The "auto" path opens the link on the SAME page the viewer is currently showing, even when the underlying TPdf is parked on a different page (v1.16.1 fix).

OnAnnotationLinkClick, OnWebLinkClick, WebLinkAtPos, LinkAnnotationAtPos