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 或更新版本