AddLinkToSubmitForm
註釋與熱點連結, 表單欄位與 AcroForms
描述
在選取的頁面上新增一個可點擊的熱點矩形，啟用後會觸發 PDF 提交表單動作。提交表單動作可將 AcroForm 欄位值傳送至 URL 或表單處理端點，無需使用 JavaScript
使用 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 提交表單動作旗標；傳入 0 使用預設 FDF 格式提交。常用標準位元包括 4（HTML 格式）、32（XFDF）及 256（提交完整 PDF 文件） |
| Options | 控制連結外觀的位元遮罩。位元 0（值 1）：在熱點矩形周圍繪製框線；位元 1-3 選擇點擊反白模式（2 = 反色、4 = 外框、8 = 下壓）；未設定反白位元時預設使用反色 |
傳回值
| 0 | 因文件處於 PDF/A 模式、矩形無效或 URL 為空，動作未新增 |
|---|---|
| 1 | 連結註釋與提交表單動作已成功新增 |
備註
PDF/A 模式會封鎖此動作，因為它可能參照外部提交目標。此函式需要 PDF 1.2 或更新版本