AddLinkToEmbeddedFile

文件屬性、註解與熱點連結

描述

在所選頁面加入 FileAttachment 註解矩形，並連結到文件中已有的內嵌檔案

先呼叫 AddEmbeddedFile 把檔案位元組複製進 PDF 並取得 EmbeddedFileID。AddLinkToEmbeddedFile 負責建立頁面註解、寫入附件標題與彈出內容，並把註解指向該內嵌檔案規格。

PDF 版本行為：FileAttachment 註解與內嵌檔案串流需要 PDF 1.3。此函式產生的註解外觀可包含透過 /CA 的註解不透明度與透明資源，那需要 PDF 1.4。目前文件版本較低且儲存版本未鎖定時，AddLinkToEmbeddedFile 會自動把文件提升到 PDF 1.4，並在 AutoBumpedFeatures 記下 /CA annotation opacity；呼叫端鎖定了較低的儲存版本時，相容性閘門會以 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。0 為完全不透明；100 讓圖示完全看不見。

傳回值

0	EmbeddedFileID 無效、未選取頁面，或沒有作用中的文件。
1	FileAttachment 註解建立成功。

另見

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount