AddLinkToNamedAction
注释和热点链接、页面属性
描述
向所选页面添加可点击的热点矩形，激活时会触发 PDF 命名操作。命名操作是由查看器控制的导航命令，定义见 ISO 32000-1 §12.6.4.11，表 194。支持的四个标准名称是 NextPage、PrevPage、FirstPage 和 LastPage。与 AddLinkToPage 不同，无需显式指定目标页码 — 查看器会在运行时解释该命令
典型用法：页面页眉或页脚上的导航按钮（下一页 / 上一页 / 首页 / 末页），其中目标相对于查看器当前显示的页面
请使用 SetAnnotBorderColor 函数更改热点边框颜色
语法
Delphi
Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;DLL
int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, int Options);参数
| Left | 热区矩形左边缘的水平坐标 |
|---|---|
| Top | 热区矩形上边缘的垂直坐标 |
| Width | 热区矩形的宽度 |
| Height | 热区矩形的高度 |
| NamedActionType | 选择要触发的指定操作：0 = NextPage、1 = PrevPage、2 = FirstPage、3 = LastPage，此范围以外的值会回退为 NextPage，因此写入器始终会输出符合规范的 /N 名称 |
| Options | 控制链接外观的位掩码。位 0（值 1）：在热点矩形周围绘制边框。位 1–3 选择点击高亮模式（2 = 反色，4 = 轮廓，8 = 按下）；未设置高亮位时，默认使用反色。约定与 AddLinkToWeb / AddLinkToPage 相同 |
备注
该注释未引用外部资源，因此与 PDF/A 兼容；需要 PDF 1.1 或更高版本