AddLinkToEmbeddedFile

分类：文档属性、注释和热点链接

描述

在所选页面添加 FileAttachment 批注矩形，并将其链接到文档中已存储的嵌入式文件

先调用 AddEmbeddedFile 将文件字节复制到 PDF 并获取 EmbeddedFileID。AddLinkToEmbeddedFile 创建页面批注，写入附件标题和弹出内容，并将批注指向该嵌入文件规范

PDF 版本行为：FileAttachment 注释和嵌入文件流需要 PDF 1.3，此函数生成的注释外观可通过 /CA 包含注释不透明度和透明度资源，这些功能需要 PDF 1.4，若当前文档版本较低且保存版本未锁定，AddLinkToEmbeddedFile 会自动将文档提升到 PDF 1.4，并记录 /CA annotation opacity 至 AutoBumpedFeatures，若调用方锁定较低的保存版本，兼容性闸门会以 LastErrorCode 602 拒绝保存

语法

Delphi

Function TPDFlib.AddLinkToEmbeddedFile(Left, Top, Width, Height: Double; EmbeddedFileID: Integer; Const Title, Contents: WideString; IconType, Transparency: Integer): Integer;

ActiveX

Function PDFlib::AddLinkToEmbeddedFile(Left As Double, Top As Double, Width As Double, Height As Double, EmbeddedFileID As Long, Title As String, Contents As String, IconType As Long, transpareny As Long) As Long

DLL

int DLAddLinkToEmbeddedFile(int InstanceID, double Left, double Top, double Width, double Height, int EmbeddedFileID, const wchar_t * Title, const wchar_t * Contents, int IconType, int transpareny);

参数

Left	注释矩形左边缘的水平坐标
Top	注释矩形上边缘的垂直坐标
Width	注释矩形宽度
Height	注释矩形高度
EmbeddedFileID	由 AddEmbeddedFile 返回的值
Title	PDF 查看器显示的附件标题
Contents	注释弹出窗口中显示的文本
IconType	注释图标：0 = 图钉，1 = 磁盘图像，2 = 无图标，3 = 图表，4 = 回形针，5 = 标签，6 = 实心白色矩形
Transparency	从 0 到 100 的透明度百分比。零表示完全不透明；100 使图标不可见

返回值

0	EmbeddedFileID 无效、未选择页面，或没有活动文档
1	已成功创建 FileAttachment 注释

另请参阅

AddEmbeddedFile、AddFileAttachment、EmbedFile、SetEmbeddedFileAFRelationship、EmbeddedFileCount