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を推奨します

関連項目

RegenerateDirtyFormAppearances, GetDirtyFormAppearanceCount