THotPDF.AddLoadedComboBox Method
向已加载文档的一个页面添加组合框(设置了 Combo 标志的下拉选择字段),并把它注册进 AcroForm。外观流显示选中的值
声明
function AddLoadedComboBox(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AValue: AnsiString; const AOptions: array of AnsiString): Integer;
单元
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
PageIndex | 接收该 widget 的已加载页面从零开始的索引 |
X1 | widget 矩形在 PDF 用户空间中的左边缘(点,原点在页面左下角) |
Y1 | widget 矩形在 PDF 用户空间中的下边缘 |
X2 | widget 矩形在 PDF 用户空间中的右边缘 |
Y2 | widget 矩形在 PDF 用户空间中的上边缘 |
AFieldName | 新字段的名称;不得与已加载表单中的既有字段重名 |
AValue | 选中的选项;留空表示不选择 |
AOptions | 下拉列表提供的选项 |
返回值
新字段的索引,供其他已加载表单字段方法使用;PageIndex 超出范围时返回 -1
使用注意事项
- 在受影响的页面、资源、字段或 catalog 对象定稿之前,在页面几何工作流中使用该 API
- 在文档定稿之前,保持对象名、字段名、资源名和返回的句柄稳定
- 已加载文档的对象引用可能是间接的;检查嵌套值之前先解析数组、字典或流