THotPDF.AddLoadedListBox Method
向已加载文档的一个页面添加列表框，并把它注册进 AcroForm。外观流列出各选项并高亮选中的那一项
声明
function AddLoadedListBox(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
- 在文档定稿之前，保持对象名、字段名、资源名和返回的句柄稳定
- 已加载文档的对象引用可能是间接的；检查嵌套值之前先解析数组、字典或流