AddLinkToResetForm
注釈とホットスポットリンク、フォームフィールドとAcroForms
説明
選択されたページに、アクティブ化されるとPDFのreset-formアクションを発火させるクリック可能なホットスポット矩形を追加します。reset-formアクションはJavaScriptを必要とせずにAcroFormフィールドをデフォルト値へ復元します resetアクションの影響を受けるフィールドを制限するには
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 reset-formアクションのフラグです。デフォルトの動作には0を渡します。標準のビューアは、このフラグビットを/Fieldsと組み合わせて、リストが包含か除外かを判断します |
| Options | リンクの外観を制御するビットマスクです。ビット0（値1）：ホットスポット矩形の周囲に境界線を描画します。ビット1-3はクリック時のハイライトモードを選択します（2 = Invert、4 = Outline、8 = Push）。ハイライトのビットが1つも設定されていない場合、デフォルトとしてInvertが使用されます |
戻り値
| 0 | ドキュメントがPDF/AモードまたはPDF/X-6モードにある、または矩形が無効なためにアクションが追加されなかった |
|---|---|
| 1 | リンク注釈とreset-formアクションが追加された |
備考
PDF/AモードとPDF/X-6モードはこのアクションをブロックします。この関数にはPDF 1.2以降が必要です