AddLinkToImportData
注釈とホットスポットリンク、フォームフィールドとAcroForms
説明
クリック可能なホットスポット矩形を選択ページに追加し、アクティブ化するとPDFのimport-dataアクションをトリガーします。import-dataアクションはディスク上のForms Data Format（FDF）ファイルからドキュメントのAcroFormフィールドを設定します。このアクションはISO 32000-1 §12.6.4.8、Table 198で定義されています
典型的な使用例: 対話型フォーム内の“サンプルデータを再読み込み”や“既定値にリセット”リンク。FDFファイルはPDFと一緒に配布され、正規のフィールド値を保持します
ホットスポットの枠線の色を変更するにはSetAnnotBorderColor関数を使用します
構文
Delphi
Function TPDFlib.AddLinkToImportData(Left, Top, Width, Height: Double; Const FileName: WideString; Options: Integer): Integer;DLL
int DLAddLinkToImportData(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int Options);パラメータ
| Left | ホットスポット矩形の左辺の水平座標 |
|---|---|
| Top | ホットスポット矩形の上辺の垂直座標 |
| Width | ホットスポット矩形の幅 |
| Height | ホットスポット矩形の高さ |
| FileName | フォームフィールドの値の読み込み元となるFDFファイルへのパスです。ISO 32000-1 §7.11.2.1のPDF正規パス形式に従い、バックスラッシュはスラッシュに変換されます。PDF生成時点でファイルは存在する必要はありませんが、アクションが成功するためには表示時点でファイルが存在していなければなりません |
| Options | リンクの外観を制御するビットマスクです。ビット0（値1）：ホットスポット矩形の周囲に境界線を描画します。ビット1–3はクリック時のハイライトモードを選択します（2 = Invert、4 = Outline、8 = Push）。ハイライトのビットが1つも設定されていない場合、デフォルトとしてInvertが使用されます。AddLinkToWeb / AddLinkToHideFieldと同じ規約です |
備考
PDF/AモードとPDF/X-6モードはImportDataアクションを拒否し、注釈を追加せずに0を返します。PDF 1.4以降が必要です