AddLinkToSubmitFormA

注释与热区链接, 表单字段与 AcroForms

说明

末尾的 A 表示 ANSI（char）DLL 入口点，ActiveX/COM 接口仅公开 Unicode 形式。其行为与 AddLinkToSubmitForm 相同，字符串参数会按照当前的 SetAnsiMode 代码页进行解释

在选定页面添加一个可点击的热区矩形，激活后触发 PDF 提交表单动作。提交表单动作无需 JavaScript 即可将 AcroForm 字段值发送至指定 URL 或表单处理端点

使用 FieldNames 可限定提交的字段范围。将 FieldNames 留空，则由 PDF 阅读器提交所有适用字段

使用 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 或更高版本