AddLinkToImportDataA
注釈とホットスポットリンク, フォームフィールドと AcroForms
説明
末尾の A は ANSI（char）DLL エントリポイントを示します。ActiveX/COM インターフェースでは Unicode 形式のみを公開します。動作は AddLinkToImportData と同じで、文字列引数は現在の SetAnsiMode コードページを使用して解釈されます
有効化時に PDF インポートデータアクションをトリガーするクリック可能なホットスポット矩形を選択したページに追加します。インポートデータアクションは、ディスク上の Forms Data Format（FDF）ファイルからドキュメント's AcroForm フィールドを設定します。このアクションは ISO 32000-1 §12.6.4.8, Table 198 で定義されています
典型的な用途は、対話フォーム内の “サンプルデータを再読み込み” または “既定値にリセット” リンクです この場合、FDF ファイルは PDF と共に配置され、正規のフィールド値を保持します
ホットスポット境界線の色を変更するには SetAnnotBorderColor 関数を使用する
構文
Delphi
Function DLAddLinkToImportDataA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; Options: Integer): Integer;DLL
int DLAddLinkToImportDataA(int InstanceID, double Left, double Top, double Width, double Height, const char * 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）。強調ビットを設定しない場合、既定で Invert を使用します。AddLinkToWeb / AddLinkToHideField と同じ規則です |
備考
アクションが外部リソースを参照するため、PDF/A では許可されません。文書が PDF/A モードの場合、関数は暗黙的に 0 を返し、注釈は追加されません。PDF 1.4 以降が必要です