AddLinkToEmbeddedPDFA
註解與熱點連結
描述
結尾的 A 表示 ANSI(char)DLL 進入點,ActiveX/COM 介面僅公開 Unicode 形式。其行為與 AddLinkToEmbeddedPDF 相同,字串引數會依據目前的 SetAnsiMode 字碼頁進行解譯
在所選頁面加入熱點連結,開啟內嵌在目前檔案中的 PDF 文件並跳到其中一頁。連結帶有 ISO 32000-1 §12.6.4.4 定義的內嵌 go-to (/GoToE) 動作:目標鏈會指名文件 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 | 文件 EmbeddedFiles 名稱樹中的內嵌檔案名稱,即傳給 EmbedFile 的名稱(例如 "report.pdf")。 |
| TargetPage | 要跳到的內嵌文件頁面(1 起算)。 |
| NewWindow | 1 = 請檢視器在新視窗開啟內嵌文件;0 = 檢視器預設行為。 |
| Options | 1 = 在熱點周圍畫框線;0 = 無框線。 |
傳回值
| 0 | 無法加入連結(名稱為空或頁面無效) |
|---|---|
| 1 | Success |