AddLinkToSubmitFormA

註釋與熱點連結, 表單欄位與 AcroForms

描述

結尾的 A 表示 ANSI（char）DLL 進入點，ActiveX/COM 介面僅公開 Unicode 形式。其行為與 AddLinkToSubmitForm 相同，字串引數會依據目前的 SetAnsiMode 字碼頁進行解譯

在選取的頁面上新增一個可點擊的熱點矩形，啟用後會觸發 PDF 提交表單動作。提交表單動作可將 AcroForm 欄位值傳送至 URL 或表單處理端點，無需使用 JavaScript

使用 FieldNames 可限制提交的欄位範圍；將 FieldNames 留空時，檢視器會提交所有適用欄位

使用 SetAnnotBorderColor 函式可變更熱點框線的顏色

語法

Delphi

Function DLAddLinkToSubmitFormA(InstanceID: Integer; Left, Top, Width, Height: Double; URL, FieldNames: PAnsiChar; Flags, Options: Integer): Integer;

DLL

int DLAddLinkToSubmitFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * URL, const char * 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 或更新版本