LinkOptions property

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