RegenerateFormAppearances
フォームフィールド、パフォーマンス
説明
AcroForm フィールド階層全体を走査し、各可視 Widget の外観ストリームを再生成します
構文
Delphi
Function TPDFlib.RegenerateFormAppearances(OnlyIfNecessary: Integer): Integer;パラメータ
| OnlyIfNecessary | 使用可能な既存外観を保持するには 0 以外を、対応している外観を再構築するには 0 を指定します |
|---|
戻り値
| 0 | 可視 Widget 外観は 1 つも再生成されませんでした |
|---|---|
| 正の値 | 正常に再生成された Widget 外観ストリームの数 |
備考
走査はルートフィールドから始まり、論理親フィールドの下のWidgetリーフを含め各子孫を1回訪れます
すべての可視Widgetが成功すると、現在セッションの未更新セットはクリアされ、NeedAppearancesはfalseになります。失敗したWidgetは未更新のまま残り、フラグはtrueのままです
既存の欠落外観が現在セッションの未更新トラッカーに表れていない、取り込まれたドキュメントにはこの完全スキャンを使用してください
現在のセッション中にこのライブラリ経由で変更された大きなフォームでは、作業が影響を受けたWidget集合に比例するようRegenerateDirtyFormAppearancesを推奨します