AddLinkToResetForm
注释和热点链接、表单域和 AcroForms
描述
向所选页面添加一个可点击的热点矩形，激活时会触发 PDF reset-form 动作。reset-form 动作无需 JavaScript 即可将 AcroForm 域恢复为默认值 使用
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 reset-form 动作标志。传 0 表示默认行为。标准查看器将这些标志位与 /Fields 结合使用，以决定列表是包含性还是排除性的 |
| Options | 控制链接外观的位掩码。位 0（值 1）：在热点矩形周围绘制边框。位 1-3 选择点击高亮模式（2 = Invert，4 = Outline，8 = Push）；未设置任何高亮位时默认使用 Invert |
返回值
| 0 | 未添加动作，原因是文档处于 PDF/A 或 PDF/X-6 模式，或矩形无效 |
|---|---|
| 1 | 链接注释和 reset-form 动作已添加 |
备注
PDF/A 和 PDF/X-6 模式会阻止该动作；该函数需要 PDF 1.2 或更高版本