LinkOptions 속성

이 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는 Pascal set of TPdfViewLinkOption입니다. 각 플래그는 한 가지 PDF link action type의 자동 처리를 켜거나 끕니다

• loAutoGoto — in-document jumps (named destinations, /GoTo / /GoToR-to-self actions). 설정하면 view가 클릭 시 PageNumber를 대상 위치로 이동합니다
• loAutoOpenURI — web links and external URIs. 설정하면 view가 해당 URI에 ShellExecute를 호출합니다
• loAutoLaunch — "launch a program / open a file on disk" actions입니다. 안전을 위해 기본값은 Off이며, 악성 launch action을 실수로 클릭해도 임의의 executable이 실행되면 안 됩니다
• loAutoEmbeddedGoto — another embedded PDF 안의 named destination으로 가는 jump를 위한 예약 항목입니다. 기본값은 Off입니다

기본값은 [loAutoGoto, loAutoOpenURI]입니다. 안전한 page jump와 URL open은 자동으로 유지되고, program-launch과 cross-document jump는 애플리케이션이 명시적으로 허용해야 합니다

각 link action은 자동 handler가 실행되기 전에 대응하는 OnAnnotationLinkClick(주석 처리된 /Link annotations) 또는 OnWebLinkClick(web-link scanner hit) event도 함께 발생시킵니다. auto-action을 억제하려면 event의 Handled 매개변수를 True로 설정하고, 그렇지 않으면 confirmation prompt / security policy / audit log를 통해 link를 다시 보냅니다

• Link click detection은 제스처가 drag가 아니라 click일 때만 동작하며, 새 MouseDown anchor를 사용하므로 panning gesture는 기존 scroll path를 그대로 통과합니다
• design-time 기본값은 Object Inspector에서 설정하거나 Active := True 전에 run-time에 할당합니다. LinkOptions는 published입니다
• loAutoOpenURI를 끄는 것은 kiosk나 untrusted-document viewer에 넣을 때 안전한 선택입니다. 아무 작업도 하기 전에 URL을 검증하는 OnWebLinkClick와 함께 사용합니다
• "auto" 경로는 underlying TPdf가 다른 page에 있더라도 viewer가 현재 보여 주는 SAME page에서 link를 엽니다(v1.16.1 fix)

OnAnnotationLinkClick, OnWebLinkClick, WebLinkAtPos, LinkAnnotationAtPos