RegenerateDirtyFormAppearances
フォームフィールド、パフォーマンス
説明
現在のドキュメントセッション中に変更された、重複排除済みの可視 Widget 外観のみを再生成します
構文
Delphi
Function TPDFlib.RegenerateDirtyFormAppearances: Integer;戻り値
| 0 | 追跡対象の Widget 外観は 1 つも再生成されませんでした |
|---|---|
| 正の値 | 正常に再生成された Widget 外観ストリームの数 |
備考
処理量はフォームフィールド総数ではなく変更された Widget セットに比例するため、大きなフォームやバッチ化された値更新に適しています成功したエントリは変更セットから外れ、失敗したエントリは保留のまま残ります。保留エントリがなくなったときにのみ
NeedAppearances
NeedAppearances は false になります典型的なバッチでは、RecalculateFormFields を 1 に設定し、フィールド値を変更し、必要に応じて
RegenerateFormAppearances を呼び出してから、保存前にこの関数を呼び出しますこの現在セッションのトラッカーは、読み込まれたドキュメントに既に存在する欠落外観を検出しません。完全なスキャンには
例
Lib.SetNeedAppearances(1);
Lib.SetFormFieldValue(InputField, '42');
Lib.RecalculateFormFields(InputField);
Refreshed:= Lib.RegenerateDirtyFormAppearances;関連項目
GetDirtyFormAppearanceCount, RegenerateFormAppearances, RecalculateFormFields