THotPDF.CreateLoadedFieldWidget Method
在已載入 PDF 的指定頁面上,以給定欄位名稱和位置矩形建立一個新的表單欄位控制項字典,用於向現有 PDF 檔案附加互動式表單控制項
宣告
function CreateLoadedFieldWidget(PageIndex: Integer; const AFieldName: AnsiString; ARect: THPDFRect): THPDFDictionaryObject;
單元
HPDFDoc
參數
| 名稱 | 用途 |
|---|---|
PageIndex | 目標頁面的零起始索引,指定控制項所屬頁面 |
AFieldName | 新欄位的唯一名稱,在同一檔案中不可與現有欄位重名 |
ARect | 控制項在頁面上的位置與尺寸矩形,使用 PDF 座標系(原點位於頁面左下角) |
X2 | CreateLoadedFieldWidget 所使用的輸入 |
Y2 | CreateLoadedFieldWidget 所使用的輸入 |
AFieldName | 該 helper 所指向的 AcroForm 欄位名稱或欄位字典 |
AFieldType | 該 helper 所指向的 AcroForm 欄位名稱或欄位字典 |
AFlags | CreateLoadedFieldWidget 所使用的輸入 |
傳回值
傳回代表新建欄位控件的 ,可進一步設定欄位類型、預設值、外觀等屬性
使用注意事項
- 呼叫此方法前應先呼叫 確保文件具備 AcroForm 字典,否则欄位注冊可能失败
- 在整個文件範圍内必須唯一,重名会导致表單資料衝突或讀取器行為不一致
- 傳回的字典物件由檔案管理生命週期,呼叫方不得手動釋放,儲存檔案後物件參照將失效