ActivateWebLinksEx

Annotations, hotspot links, and text extraction

Description

Creates URI link annotations over selected kinds of web and email text on a PDF page range

Syntax

Function TPDFlib.ActivateWebLinksEx(Const PageRange: WideString; Options: Integer): Integer;

Parameters

PageRange	Page numbers and ranges such as `1,3,5-8`; an empty value selects every page
Options	A bitwise combination of `PDF_WEB_LINK_DETECT_HTTP` for HTTP and HTTPS, `PDF_WEB_LINK_DETECT_WWW` for `www.` addresses, `PDF_WEB_LINK_DETECT_FTP` for FTP, `PDF_WEB_LINK_DETECT_EMAIL` for `mailto:` and bare email addresses, and `PDF_WEB_LINK_DRAW_BORDER` for a visible blue border; `PDF_WEB_LINK_DEFAULT` combines all detection flags without a border

Return values

Returns the number of new link annotations created; returns 0 when no detection flag is enabled, no new target is found, processing is cancelled before a match, or tagged-document safety rejects the operation

Remarks

Detection, geometry, duplicate suppression, PDF/A annotation flags, progress, cancellation, selected-page restoration, and tagged-document restrictions are identical to ActivateWebLinks