ActivateWebLinks
Аннотации, активные ссылки и извлечение текста
Описание
Находит веб-адреса и адреса почты в существующем тексте страницы и создает неповторяющиеся аннотации Link с действиями URI
Синтаксис
Function TPDFlib.ActivateWebLinks(Const PageRange: WideString): Integer;Параметры
| PageRange | Номера страниц и диапазоны вида 1,3,5-8; пустое значение выбирает все страницы |
|---|
Возвращаемые значения
Возвращает число созданных новых аннотаций-ссылок
Примечания
Детектор по умолчанию распознает http://, https://, www., ftp://, mailto: и голые адреса почты; цели www. получают схему https://, а голые адреса — схему mailto:
Каждая страница извлекается один раз, прямоугольники ссылок выводятся из продвижений совпавших символов, а не выровненный по осям текст получает /QuadPoints, когда активное соответствие PDF разрешает возможности PDF 1.6
Существующая URI-ссылка с тем же каноническим целевым адресом и существенно перекрывающимся прямоугольником сохраняется, поэтому повторные вызовы идемпотентны
Детекция использует ASCII-синтаксис URI; не-ASCII имена хостов и пути кодируйте Punycode или percent-кодированием перед вызовом этого метода
Tagged PDF and PDF/UA documents are left unchanged because inserting an annotation without updating its structure-tree association would break conformance; the method returns 0 and sets LastErrorCode to PDFLIB_ERROR_TAGGED_LINK_STRUCTURE
Метод сообщает прогресс по страницам, уважает отмену и восстанавливает выбранную страницу