AddLinkToResetForm

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

說明

在選取的頁面上新增一個可點擊的熱點矩形,啟用後會觸發 PDF 重設表單動作。重設表單動作可將 AcroForm 欄位還原為預設值,無需使用 JavaScript

使用 FieldNames 可限制受重設動作影響的欄位範圍;將 FieldNames 留空時,檢視器會重設所有適用欄位

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

語法

Delphi

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

DLL

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

參數

Left熱點矩形左邊緣的水平座標
Top熱點矩形上邊緣的垂直座標
Width熱點矩形的寬度
Height熱點矩形的高度
FieldNames以逗號、分號或換行符號分隔的完整 AcroForm 欄位名稱選用清單,每個名稱前後的空白會自動去除
Flags寫入動作 /Flags 項目的 PDF 重設表單動作旗標;傳入 0 使用預設行為。標準檢視器依據旗標位元與 /Fields 判斷清單為包含或排除模式
Options控制連結外觀的位元遮罩。位元 0(值 1):在熱點矩形周圍繪製框線;位元 1-3 選擇點擊反白模式(2 = 反色、4 = 外框、8 = 下壓);未設定反白位元時預設使用反色

傳回值

0因文件處於 PDF/A 模式或矩形無效,動作未新增
1連結註釋與重設表單動作已成功新增

說明

PDF/A 模式會封鎖此動作,因為互動式表單動作不符合封存合規要求。此函式需要 PDF 1.2 或更新版本