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 以降が必要です