AddLinkToHideFieldA
注釈とホットスポットリンク, フォームフィールドと AcroForms
説明
末尾の A は ANSI（char）DLL エントリポイントを示します。ActiveX/COM インターフェースでは Unicode 形式のみを公開します。動作は AddLinkToHideField と同じで、文字列引数は現在の SetAnsiMode コードページを使用して解釈されます
選択したページに、アクティブ化すると PDF hide アクションを起動するクリック可能なホットスポット長方形を追加します。hide アクションは 1 つ以上の AcroForm フィールドの表示状態を切り替え、JavaScript を使わずに動的な表示と非表示を可能にします。このアクションは ISO 32000-1 §12.6.4.10, Table 196 で定義されています
代表的な用途: フォームレイアウトの “詳細を表示” / “詳細を非表示” リンク、または相互排他的なフィールドグループで、1 つのリンクをクリックすると一方のグループを隠して他方を表示する場合です (反対の HideFlag 値を指定した 2 つの 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 フィールド名を 1 つ以上指定します 区切りにはカンマ、セミコロン、または改行を使用します 各名前の前後の空白はトリミングされます 1 つの名前はテキスト文字列として /T を出力し、2 つ以上はテキスト文字列の配列として /T を出力します |
| HideFlag | 可視性の方向を選択します。0 以外の値は一覧のフィールドを非表示にします（/H true）。0 は表示します（/H false） |
| Options | リンクの外観を制御するビットマスクです。ビット 0（値 1）はホットスポット矩形の周囲に枠線を描画します。ビット 1–3 はクリック時の強調表示モードを選択します（2 = Invert、4 = Outline、8 = Push）。強調表示ビットが設定されない場合は既定で Invert を使用します。AddLinkToWeb / AddLinkToNamedAction と同じ規約です |
備考
外部リソースを参照しないため、この注釈は PDF/A 互換です。PDF 1.2 以降が必要です