THotPDF.CreateLoadedFieldWidget Method
方法摘要: THotPDF.CreateLoadedFieldWidget Method
声明
function CreateLoadedFieldWidget(PageIndex: Integer; const AFieldName: AnsiString; ARect: THPDFRect): THPDFDictionaryObject;
单元
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
PageIndex | 目标页面的零起始索引,指定控件所属页面 |
X1 | CreateLoadedFieldWidget 使用的输入 |
Y1 | CreateLoadedFieldWidget 使用的输入 |
X2 | CreateLoadedFieldWidget 使用的输入 |
Y2 | CreateLoadedFieldWidget 使用的输入 |
AFieldName | 新字段的唯一名称,在同一文档中不可与现有字段重名 |
ARect | 该辅助方法针对的 AcroForm 字段名称或字段字典 |
AFlags | CreateLoadedFieldWidget 使用的输入 |
返回值
返回 THPDFDictionaryObject 值
使用注意事项
- 调用此方法前应先调用 EnsureLoadedAcroForm 确保文档具备 AcroForm 字典,否则字段注册可能失败
- AFieldName 在整个文档范围内必须唯一,重名会导致表单数据冲突或读取器行为不一致
- 返回的字典对象由文档管理生命周期,调用方不得手动释放,保存文档后对象引用将失效