AddLinkToResetForm
注釈とホットスポットリンク, フォームフィールドと AcroForms
説明
選択ページにクリック可能なホットスポット矩形を追加します。この矩形をクリックすると PDF フォームリセットアクションが実行されます。フォームリセットアクションは JavaScript を使用せずに AcroForm フィールドをデフォルト値に戻します
FieldNames を使用してリセット対象フィールドを限定してください。FieldNames を空にした場合、ビューアーは適用可能なすべてのフィールドをリセットします
SetAnnotBorderColor 関数を使用してホットスポット境界線の色を変更できます
構文
Delphi
Function TPDFlib.AddLinkToResetForm(Left, Top, Width, Height: Double; Const FieldNames: WideString; Flags, Options: Integer): Integer;
DLL
int DLAddLinkToResetForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FieldNames, int Flags, int Options);
パラメーター
| Left | ホットスポット矩形の左端の水平座標 |
|---|---|
| Top | ホットスポット矩形の上端の垂直座標 |
| Width | ホットスポット矩形の幅 |
| Height | ホットスポット矩形の高さ |
| FieldNames | コンマ、セミコロン、または改行で区切られた AcroForm フィールド名の完全修飾リスト(省略可能)。各名前前後の空白は除去されます |
| Flags | アクションの /Flags エントリに書き込まれる PDF フォームリセットアクションフラグ。デフォルト動作の場合は 0 を渡してください。標準ビューアーは /Fields とともにフラグビットを使用してリストが包含的か排他的かを決定します |
| Options | リンク外観を制御するビットマスク。ビット 0(値 1): ホットスポット矩形の周囲に境界線を描画します。ビット 1-3 はクリックハイライトモードを選択します(2 = 反転、4 = アウトライン、8 = プッシュ)。ハイライトビットが設定されていない場合は反転がデフォルトとして使用されます |
戻り値
| 0 | 文書が PDF/A モードである、または矩形が無効なためアクションが追加されませんでした |
|---|---|
| 1 | リンク注釈とフォームリセットアクションが追加されました |
注意事項
PDF/A モードでは、アーカイブ適合性のためにインタラクティブフォームアクションが使用できないため、このアクションはブロックされます。この関数は PDF 1.2 以降が必要です