LinkOptions Свойство

Эта запись API сохраняет идентификаторы, сигнатуры, блоки кода и термины PDF в исходном виде.

Опубликованное множество, которое управляет тем, какие из четырех типов действий ссылки PDFium просмотрщик выполняет автоматически, когда пользователь щелкает ссылку

LinkOptions — это Pascal set of TPdfViewLinkOption Каждый флаг включает или отключает автоматическую обработку одного типа действия PDF-ссылки:

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

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

Каждое действие ссылки также вызывает соответствующее событие OnAnnotationLinkClick (аннотированные аннотации /Link) или OnWebLinkClick (совпадения web-link scanner) ДО того, как сработает автоматический обработчик Пометьте параметр события Handled как True, чтобы подавить авто-действие, или перенаправить ссылку через запрос подтверждения / политику безопасности / журнал аудита

• Обнаружение щелчка по ссылке работает только тогда, когда жест является щелчком, а не перетаскиванием, используя свежий якорь MouseDown, чтобы жесты панорамирования по-прежнему шли по существующему пути прокрутки без изменений
• Задавайте значения по умолчанию на этапе проектирования в Object Inspector или присваивайте их во время выполнения перед Active := True; LinkOptions является опубликованным свойством
• Отключение loAutoOpenURI является безопасным выбором для встраивания в kiosk или просмотрщик недоверенных документов — сочетайте его с OnWebLinkClick, который проверяет URL перед выполнением чего-либо
• Путь "auto" открывает ссылку на ТОЙ ЖЕ странице, которую просмотрщик сейчас показывает, даже когда базовый TPdf находится на другой странице (исправление v1.16.1)

OnAnnotationLinkClick, OnWebLinkClick, WebLinkAtPos, LinkAnnotationAtPos