THotPDF.AddLoadedCheckBox Method
在已載入文件的頁面上新增核取方塊，並註冊到 AcroForm。欄位會取得 on 與 off 兩種外觀狀態，外觀狀態跟隨 AChecked
宣告
function AddLoadedCheckBox(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AExportValue: AnsiString; AChecked: boolean): Integer;單元
HPDFDoc
參數
| 名稱 | 用途 |
|---|---|
PageIndex | 接收此 widget 的已載入頁面索引（從零開始） |
X1 | widget 矩形在 PDF 使用者空間中的左緣（單位為 point，原點在頁面左下角） |
Y1 | widget 矩形在 PDF 使用者空間中的下緣 |
X2 | widget 矩形在 PDF 使用者空間中的右緣 |
Y2 | widget 矩形在 PDF 使用者空間中的上緣 |
AFieldName | 新欄位的名稱；已載入表單中不得已有同名欄位 |
AExportValue | on 狀態的名稱，也是勾選時匯出的值；留空則為 Yes |
AChecked | True 表示建立時即為勾選狀態 |
傳回值
新欄位的索引，可搭配其他已載入表單欄位方法使用；PageIndex 超出範圍時傳回 -1
使用說明
- 在 AcroForm 工作流程中使用此 API，並在受影響的頁面、資源、欄位或 catalog 物件定案之前呼叫
- 在文件定案之前，保持物件名稱、欄位名稱、資源名稱與傳回的 handle 穩定不變
- 已載入文件的物件參照可能是間接參照；檢查巢狀值之前，請先解析陣列、字典或串流