AddLinkToHideFieldA
註釋與熱點連結, 表單欄位與 AcroForms
描述
結尾的 A 表示 ANSI（char）DLL 進入點；ActiveX/COM 介面只提供 Unicode 形式。行為與 AddLinkToHideField 完全相同，字串參數依目前 SetAnsiMode 的字碼頁解讀
在所選頁面加入可點擊的熱點矩形，啟用時觸發 PDF hide 動作。hide 動作會切換一或多個 AcroForm 欄位的可見性，不需 JavaScript 就能動態顯示/隱藏。此動作定義於 ISO 32000-1 §12.6.4.10, Table 196
典型用法：表單版面中的「顯示詳情」/「隱藏詳情」連結，或互斥欄位群組——點某個連結隱藏一群組、顯示另一群組（用兩個 HideFlag 值相反的 AddLinkToHideField 呼叫組合）。
要變更熱點框線顏色，請用 SetAnnotBorderColor 函式。
語法
Delphi
Function DLAddLinkToHideFieldA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; HideFlag, Options: Integer): Integer;DLL
int DLAddLinkToHideFieldA(int InstanceID, double Left, double Top, double Width, double Height, const char * FieldNames, int HideFlag, int Options);參數
| Left | 熱點矩形左邊緣的水平座標 |
|---|---|
| Top | 熱點矩形上邊緣的垂直座標 |
| Width | 熱點矩形的寬度 |
| Height | 熱點矩形的高度 |
| FieldNames | 一或多個完整限定的 AcroForm 欄位名稱，以逗號、分號或換行分隔。每個名稱前後的空白會去除。單一名稱時 /T 以文字字串寫出；兩個以上時 /T 以文字字串陣列寫出。 |
| HideFlag | 選擇可見性方向。非零值隱藏列出的欄位（/H true）；零顯示它們（/H false）。 |
| Options | 控制連結外觀的位元遮罩。位元 0（值 1）：在熱點矩形周圍畫框線。位元 1–3 選擇點擊高亮模式（2 = Invert，4 = Outline，8 = Push）；未設任何高亮位元時，預設使用 Invert。與 AddLinkToWeb / AddLinkToNamedAction 同一慣例。 |
備註
註解與 PDF/A 相容，因為沒有參照外部資源。需要 PDF 1.2 以上