SetNeedAppearances

表單欄位

描述

設定文件的 NeedAppearances 值,用於 AcroForm 外觀處理

批次變更欄位時把值設為 1,程式庫會記錄變更過的 Widget 外觀而不立即逐一重建;儲存前再呼叫 RegenerateDirtyFormAppearances

把值設為 0,要求每次支援的欄位變更後立即重建外觀

文件必須至少有一個表單欄位,此函數才會產生作用

語法

Delphi

Function TPDFlib.SetNeedAppearances(NewValue: Integer): Integer;

ActiveX

Function PDFlib::SetNeedAppearances(NewValue As Long) As Long

DLL

int DLSetNeedAppearances(int InstanceID, int NewValue);

參數

NewValue0 會將 NeedAppearances 設為 false;1 會將其設為 true

傳回值

0文件沒有任何表單欄位
1NeedAppearances 值已成功設定

備註

PDF 2.0 要求 Widget 附註必須有外觀串流,並不建議依賴 NeedAppearances;請在產生 PDF 2.0 輸出之前重新產生擱置中的外觀目前工作階段的待更新追蹤器無法找出已載入文件中原本就缺失的外觀,因此請使用

RegenerateFormAppearances 對匯入的文件進行完整掃描

另請參閱

GetDirtyFormAppearanceCount, RegenerateDirtyFormAppearances, RegenerateFormAppearances