AddLinkToHideField
注釈とホットスポットリンク、フォームフィールドとAcroForms
説明
クリック可能なホットスポット矩形を選択ページに追加し、アクティブ化するとPDFのhideアクションをトリガーします。hideアクションは1つ以上のAcroFormフィールドの表示を切り替え、JavaScriptなしで動的な表示/非表示を実現します。このアクションはISO 32000-1 §12.6.4.10、Table 196で定義されています
典型的な使用例: フォームレイアウト内の“詳細を表示”/“詳細を非表示”リンクや、片方のリンクをクリックすると一方のグループを非表示にして他方を表示する排他フィールドグループ（HideFlag値を逆にした2つの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 | 1つ以上の完全修飾AcroFormフィールド名。カンマ、セミコロン、または改行で区切ります。各名前の前後の空白は取り除かれます。名前が1つの場合は/Tがテキスト文字列として出力され、2つ以上の場合は/Tがテキスト文字列の配列として出力されます |
| HideFlag | 表示方向を選択します。0以外の値は列挙されたフィールドを非表示にし（/H true）、0は表示します（/H false） |
| Options | リンクの外観を制御するビットマスクです。ビット0（値1）：ホットスポット矩形の周囲に境界線を描画します。ビット1–3はクリック時のハイライトモードを選択します（2 = Invert、4 = Outline、8 = Push）。ハイライトのビットが1つも設定されていない場合、デフォルトとしてInvertが使用されます。AddLinkToWeb / AddLinkToNamedActionと同じ規約です |
備考
PDF/AモードとPDF/X-6モードはHideアクションを拒否して0を返します。PDF 1.2以降が必要です