THotPDF.AddLoadedTextField Method
在已載入文件的頁面上新增文字欄位，並註冊到 AcroForm。欄位會取得顯示其值的外觀串流，AcroForm 也會取得其 /DA 字串所指名的 Helvetica 預設字型，因此每個檢視器都會顯示這個欄位
宣告
function AddLoadedTextField(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AValue: AnsiString; AMaxLen: Integer): Integer;單元
HPDFDoc
參數
| 名稱 | 用途 |
|---|---|
PageIndex | 接收此 widget 的已載入頁面索引（從零開始） |
X1 | widget 矩形在 PDF 使用者空間中的左緣（單位為 point，原點在頁面左下角） |
Y1 | widget 矩形在 PDF 使用者空間中的下緣 |
X2 | widget 矩形在 PDF 使用者空間中的右緣 |
Y2 | widget 矩形在 PDF 使用者空間中的上緣 |
AFieldName | 新欄位的名稱；已載入表單中不得已有同名欄位 |
AValue | 初始值；留空表示空白欄位 |
AMaxLen | 最大字元數，0 表示不設上限 |
傳回值
新欄位的索引，可搭配其他已載入表單欄位方法使用；PageIndex 超出範圍時傳回 -1
使用說明
- 請在 AcroForm 工作流程中，於受影響的頁面、資源、欄位或 catalog 物件完成處理之前使用此 API
- 在文件定案之前，保持物件名稱、欄位名稱、資源名稱與傳回的 handle 穩定不變
- 已載入文件的物件參照可能是間接參照；檢查巢狀值之前，請先解析陣列、字典或串流