RegenerateFormAppearances
表單欄位、效能
描述
走訪完整的 AcroForm 欄位階層，並為每個可見的 Widget 重新產生外觀串流
語法
Delphi
Function TPDFlib.RegenerateFormAppearances(OnlyIfNecessary: Integer): Integer;參數
| OnlyIfNecessary | 使用非零值以保留現有可用的外觀，或使用 0 重建支援的外觀 |
|---|
傳回值
| 0 | 沒有重新產生任何可見的 Widget 外觀 |
|---|---|
| 正值 | 成功重新產生的 Widget 外觀串流數量 |
備註
走訪從根欄位開始，每個後代只造訪一次，包括邏輯父欄位下的 Widget 葉節點
所有可見 Widget 都成功時，本次 session 的待重繪集合會被清除，NeedAppearances 變為 false；失敗的 Widget 保持待重繪，旗標維持 true
匯入的文件可能帶有本次 session 待重繪追蹤器看不到的既有缺失外觀，這類文件請用這個完整掃描
本次 session 透過本程式庫變更過的大型表單，建議改用 RegenerateDirtyFormAppearances，讓工作量隨受影響的 Widget 集合縮放