AddLinkToHideField
註解與熱點連結、表單欄位與 AcroForms
描述
在所選頁面加入可點擊的熱點矩形，啟用時觸發 PDF 隱藏動作。隱藏動作會切換一或多個 AcroForm 欄位的可見狀態，不需 JavaScript 即可達成動態顯示/隱藏。該動作定義於 ISO 32000-1 §12.6.4.10, Table 196。
典型用途：表單版面中的「顯示細節」/「隱藏細節」連結，或互斥的欄位群組，點擊其中一個連結會隱藏一個群組並顯示另一個（以相反的 HideFlag 值組合兩次 AddLinkToHideField 呼叫）。
請使用 SetAnnotBorderColor 函數變更熱點邊框的顏色。
語法
Delphi
Function TPDFlib.AddLinkToHideField(Left, Top, Width, Height: Double; Const FieldNames: WideString; HideFlag: Integer; Options: Integer): Integer;DLL
int DLAddLinkToHideField(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * 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/X-6 模式會拒絕 Hide 動作並傳回 0；需要 PDF 1.2 或更新版本