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 |
傳回值
| 0 | DestName 為空,或無法建立連結 |
|---|---|
| 1 | 具名目的地連結已加入所選頁面 |
備註
連結註解寫出 GoTo 動作,目的地就是具名目的地字串。具名目的地建立後,即使之後插入或移動頁面,熱點仍然穩定