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 用户空间中的左边缘（点，原点在页面左下角） |
Y1 | widget 矩形在 PDF 用户空间中的下边缘 |
X2 | widget 矩形在 PDF 用户空间中的右边缘 |
Y2 | widget 矩形在 PDF 用户空间中的上边缘 |
AFieldName | 新字段的名称；不得与已加载表单中的既有字段重名 |
AValue | 初始值；留空表示空白字段 |
AMaxLen | 最大字符数，0 表示不限制 |
返回值
新字段的索引，供其他已加载表单字段方法使用；PageIndex 超出范围时返回 -1
使用注意事项
- 在受影响的页面、资源、字段或 catalog 对象定稿之前，在 AcroForm 工作流中使用该 API
- 在文档定稿之前，保持对象名、字段名、资源名和返回的句柄稳定
- 已加载文档的对象引用可能是间接的；检查嵌套值之前先解析数组、字典或流