AddLinkToNamedAction
註解與熱點連結、頁面屬性
描述
在所選頁面加入可點擊的熱點矩形，啟用時觸發 PDF 具名動作。具名動作是定義於 ISO 32000-1 §12.6.4.11, Table 194 的檢視器導覽指令，支援的四個標準名稱為 NextPage、PrevPage、FirstPage 與 LastPage。與 AddLinkToPage 不同，這裡不需要明確指定目的地頁碼 — 檢視器會在執行期解讀指令
典型用法：頁首或頁尾上的導覽按鈕（下一頁/上一頁/首頁/末頁），目的地相對於檢視器目前顯示的頁面。
要變更熱點框線顏色，請用 SetAnnotBorderColor 函式。
語法
Delphi
Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;DLL
int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, int Options);參數
| Left | 熱點矩形左邊緣的水平座標 |
|---|---|
| Top | 熱點矩形上邊緣的垂直座標 |
| Width | 熱點矩形的寬度 |
| Height | 熱點矩形的高度 |
| NamedActionType | 選擇要觸發的具名動作：0 = NextPage，1 = PrevPage，2 = FirstPage，3 = LastPage。超出此範圍的值回退到 NextPage，寫入器因此一定輸出符合規格的 /N 名稱。 |
| Options | 控制連結外觀的位元遮罩。位元 0（值 1）：在熱點矩形周圍畫框線。位元 1–3 選擇點擊高亮模式（2 = Invert，4 = Outline，8 = Push）；未設任何高亮位元時，預設使用 Invert。與 AddLinkToWeb / AddLinkToPage 同一慣例。 |
備註
註解與 PDF/A 相容，因為沒有參照外部資源。需要 PDF 1.1 以上