AddLinkToNamedDestination
注释和热点链接、页面属性
描述
向所选页面添加可单击的热点矩形,该矩形会跳转到同一 PDF 文档中的指定目标,先使用 NewDestination 和 NewNamedDestination 注册目标,然后创建引用稳定目标名称的热点,而不是重复页码和目标数组
请使用 SetAnnotBorderColor 函数更改热点边框颜色
语法
Delphi
Function TPDFlib.AddLinkToNamedDestination(Left, Top, Width, Height: Double; Const DestName: WideString; Options: Integer): Integer;
DLL
int DLAddLinkToNamedDestination(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * DestName, int Options);
参数
| Left | 热区矩形左边缘的水平坐标 |
|---|---|
| Top | 热区矩形上边缘的垂直坐标 |
| Width | 热区矩形的宽度 |
| Height | 热区矩形的高度 |
| DestName | 要跳转到的命名目标。该名称应已存在于文档名称树中,通常通过 NewNamedDestination 创建 |
| Options | 控制链接外观的位掩码。位 0(值为 1):在热点矩形周围绘制边框。位 1–3 选择单击高亮模式(2 = Invert、4 = Outline、8 = Push);未设置高亮位时,默认使用 Invert |
返回值
| 0 | DestName 为空或无法创建链接 |
|---|---|
| 1 | 已将命名目标链接添加至所选页面 |
备注
链接注释会写入 GoTo 操作,其目标为命名目标字符串;这样在创建命名目标后插入或移动页面时,热点仍保持稳定