AddLinkToSubmitForm

注釈とホットスポットリンク, フォームフィールドと AcroForms

説明

選択ページにクリック可能なホットスポット矩形を追加します。この矩形をクリックすると PDF フォーム送信アクションが実行されます。フォーム送信アクションは JavaScript を使用せずに AcroForm フィールドの値を URL またはフォーム処理エンドポイントに送信します

FieldNames を使用して送信対象フィールドを限定してください。FieldNames を空にした場合、ビューアーは適用可能なすべてのフィールドを送信します

SetAnnotBorderColor 関数を使用してホットスポット境界線の色を変更できます

構文

Delphi

Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;

DLL

int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, int Options);

パラメーター

Left	ホットスポット矩形の左端の水平座標
Top	ホットスポット矩形の上端の垂直座標
Width	ホットスポット矩形の幅
Height	ホットスポット矩形の高さ
URL	アクションファイル仕様に格納される送信先 URL
FieldNames	コンマ、セミコロン、または改行で区切られた AcroForm フィールド名の完全修飾リスト（省略可能）。各名前前後の空白は除去されます
Flags	アクションの `/Flags` エントリに書き込まれる PDF フォーム送信アクションフラグ。デフォルトの FDF 形式送信の場合は 0 を渡してください。一般的な標準ビットには HTML 形式が 4、XFDF が 32、PDF 文書全体を送信する場合は 256 があります
Options	リンク外観を制御するビットマスク。ビット 0（値 1）: ホットスポット矩形の周囲に境界線を描画します。ビット 1-3 はクリックハイライトモードを選択します（2 = 反転、4 = アウトライン、8 = プッシュ）。ハイライトビットが設定されていない場合は反転がデフォルトとして使用されます

戻り値

0	文書が PDF/A モードである、矩形が無効である、または `URL` が空のためアクションが追加されませんでした
1	リンク注釈とフォーム送信アクションが追加されました

注意事項

PDF/A モードでは外部送信先を参照できないため、このアクションはブロックされます。この関数は PDF 1.2 以降が必要です