AddLinkToEmbeddedPDFA

注释和热点链接

描述

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

向选定页面添加热点链接,该链接会打开嵌入当前文件的 PDF 文档并跳转到其中的某一页。该链接根据 ISO 32000-1 §12.6.4.4 带有嵌入式转到(/GoToE)操作:其目标链会在文档's EmbeddedFiles 名称树中指定嵌入文件(传给 EmbedFile 的名称),且目标位置会使目标页适合窗口

由于 /GoToE 在 PDF 1.6 中引入,必要时调用此函数会将文档版本提高到 1.6。使用 GetAnnotActionInfo 可读回此类操作:它会报告类型 akGoToE,以及嵌入目标名称、父子关系和 /NewWindow 标志

语法

Delphi

Function DLAddLinkToEmbeddedPDFA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileName: PAnsiChar; TargetPage, NewWindow, Options: Integer): Integer;

DLL

int DLAddLinkToEmbeddedPDFA(int InstanceID, double Left, double Top, double Width, double Height, const char * EmbeddedFileName, int TargetPage, int NewWindow, int Options);

参数

Left, Top, Width, Height所选页面上热点区域的位置和大小
EmbeddedFileName文档's EmbeddedFiles 名称树中嵌入文件的名称,按传递给 EmbedFile 的名称使用(例如 "report.pdf")
TargetPage嵌入文档中要跳转到的从一开始的页面
NewWindow1 = 请求查看器在新窗口中打开嵌入文档,0 = 查看器默认值
Options1 = 在热点周围绘制边框,0 = 无边框

返回值

0无法添加链接(名称为空或页面无效)
1Success