AddLinkToHideField

注释和热点链接、表单域和 AcroForms

描述

在所选页面添加可点击的热点矩形,激活时触发 PDF hide 动作。hide 动作切换一个或多个 AcroForm 字段的可见性,无需 JavaScript 即可实现动态显示/隐藏。该动作定义于 ISO 32000-1 §12.6.4.10、表 196

典型用途:表单布局中的“显示详情”/“隐藏详情”链接,或点击一个链接即隐藏一组、显示另一组的互斥字段组(组合两次 HideFlag 值相反的 AddLinkToHideField 调用)

请使用 SetAnnotBorderColor 函数更改热点边框颜色

语法

Delphi

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

DLL

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

参数

Left热点矩形左边缘的水平坐标
Top热点矩形上边缘的垂直坐标
Width热点矩形的宽度
Height热点矩形的高度
FieldNames一个或多个完全限定的 AcroForm 域名称,以逗号、分号或换行分隔。每个名称前后的空白会被去除。单个名称将 /T 作为文本字符串写出;两个或更多名称将 /T 作为文本字符串数组写出。
HideFlag选择可见性方向。非零值隐藏列出的域(/H true);零显示它们(/H false)。
Options控制链接外观的位掩码。位 0(值 1):在热点矩形周围绘制边框。位 1–3 选择点击高亮模式(2 = Invert,4 = Outline,8 = Push);未设置任何高亮位时默认使用 Invert。约定与 AddLinkToWeb / AddLinkToNamedAction 相同。

备注

PDF/A 和 PDF/X-6 模式拒绝 Hide 动作并返回 0;需要 PDF 1.2 或更高版本