AddLinkToNamedDestinationA

註解與熱點連結、頁面屬性

描述

結尾的 A 表示 ANSI(char)DLL 進入點;ActiveX/COM 介面只提供 Unicode 形式。行為與 AddLinkToNamedDestination 完全相同,字串參數依目前 SetAnsiMode 的字碼頁解讀

在所選頁面加入可點擊的熱點矩形,跳到同一份 PDF 文件中的具名目的地。先用 NewDestination 與 NewNamedDestination 註冊目標,再建立引用這個穩定目的地名稱的熱點,不必重複寫死頁碼與目的地陣列

要變更熱點框線顏色,請用 SetAnnotBorderColor 函式。

語法

Delphi

Function DLAddLinkToNamedDestinationA(InstanceID: Integer; Left, Top, Width, Height: Double; DestName: PAnsiChar; Options: Integer): Integer;

DLL

int DLAddLinkToNamedDestinationA(int InstanceID, double Left, double Top, double Width, double Height, const char * DestName, int Options);

參數

Left熱點矩形左邊緣的水平座標
Top熱點矩形上邊緣的垂直座標
Width熱點矩形的寬度
Height熱點矩形的高度
DestName要跳到的具名目的地。名稱應已存在於文件名稱樹,通常是透過 NewNamedDestination 建立
Options控制連結外觀的位元遮罩。位元 0(值 1):在熱點矩形周圍畫框線。位元 1–3 選擇點擊高亮模式(2 = Invert,4 = Outline,8 = Push);未設任何高亮位元時,預設使用 Invert

傳回值

0DestName 為空,或無法建立連結
1具名目的地連結已加入所選頁面

備註

連結註解寫出 GoTo 動作,目的地就是具名目的地字串。具名目的地建立後,即使之後插入或移動頁面,熱點仍然穩定