AddLinkToResetFormA
注释与热区链接, 表单字段与 AcroForms
说明
末尾的 A 表示 ANSI（char）DLL 入口点，ActiveX/COM 接口仅公开 Unicode 形式。其行为与 AddLinkToResetForm 相同，字符串参数会按照当前的 SetAnsiMode 代码页进行解释
在选定页面添加一个可点击的热区矩形，激活后触发 PDF 重置表单动作。重置表单动作无需 JavaScript 即可将 AcroForm 字段还原为默认值
使用 FieldNames 可限定受重置动作影响的字段范围。将 FieldNames 留空，则由 PDF 阅读器重置所有适用字段
使用 SetAnnotBorderColor 函数可更改热区边框颜色
语法
Delphi
Function DLAddLinkToResetFormA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; Flags, Options: Integer): Integer;DLL
int DLAddLinkToResetFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * 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 或更高版本