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 用户空间中的左边缘(点,原点在页面左下角) |
Y1 | widget 矩形在 PDF 用户空间中的下边缘 |
X2 | widget 矩形在 PDF 用户空间中的右边缘 |
Y2 | widget 矩形在 PDF 用户空间中的上边缘 |
AFieldName | 新字段的名称;不得与已加载表单中的既有字段重名 |
AExportValue | on 状态的名称,也是勾选时导出的值;留空时为 Yes |
AChecked | 传 True 则创建为勾选状态 |
返回值
新字段的索引,供其他已加载表单字段方法使用;PageIndex 超出范围时返回 -1
使用注意事项
- 在受影响的页面、资源、字段或 catalog 对象定稿之前,在页面几何工作流中使用该 API
- 在文档定稿之前,保持对象名、字段名、资源名和返回的句柄稳定
- 已加载文档的对象引用可能是间接的;检查嵌套值之前先解析数组、字典或流