ActivateWebLinks

注釈、ホットスポットリンク、テキスト抽出

説明

既存のページテキストで Web アドレスとメールアドレスを検出し、URI アクション付きの重複しない Link 注釈を作成します

Function TPDFlib.ActivateWebLinks(Const PageRange: WideString): Integer;

PageRange	`1,3,5-8` のようなページ番号と範囲。空値はすべてのページを選択します

作成された新しいリンク注釈の数を返します

既定の検出器は http://、https://、www.、ftp://、mailto:、および裸のメールアドレスを認識します。www. ターゲットには https:// スキームが、裸のアドレスには mailto: スキームが追加されます

各ページは 1 回だけ抽出され、リンク矩形は一致文字のアドバンスから導出されます。軸に平行でないテキストには、アクティブな PDF 適合性が PDF 1.6 機能を許可する場合に /QuadPoints が付与されます

同じ正規化された対象と大きく重なる矩形を持つ既存の URI リンクは保持されるため、繰り返し呼び出しても冪等です

検出では ASCII URI 構文を使用します。このメソッドを呼び出す前に、ASCII 以外のホスト名とパスを Punycode またはパーセントエンコーディングでエンコードしてください

構造ツリーの関連付けを更新せずに注釈を挿入すると適合性が損なわれるため、Tagged PDF と PDF/UA 文書は変更されません。メソッドは 0 を返し、LastErrorCode を PDFLIB_ERROR_TAGGED_LINK_STRUCTURE に設定します

このメソッドはページごとの進行状況を報告し、キャンセルに従い、選択されていたページを復元します