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

返回值

0DestName 为空或无法创建链接
1已将命名目标链接添加至所选页面

备注

链接注释会写入 GoTo 操作,其目标为命名目标字符串;这样在创建命名目标后插入或移动页面时,热点仍保持稳定