THotPDF.AddLoadedPushButton Method
向已加载文档的一个页面添加下压按钮，并把它注册进 AcroForm。外观流把 ACaption 居中绘制在按钮里
声明
function AddLoadedPushButton(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, ACaption: AnsiString): Integer;单元
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
PageIndex | 接收该 widget 的已加载页面从零开始的索引 |
X1 | widget 矩形在 PDF 用户空间中的左边缘（点，原点在页面左下角） |
Y1 | widget 矩形在 PDF 用户空间中的下边缘 |
X2 | widget 矩形在 PDF 用户空间中的右边缘 |
Y2 | widget 矩形在 PDF 用户空间中的上边缘 |
AFieldName | 新字段的名称；不得与已加载表单中的既有字段重名 |
ACaption | 按钮标题，存入 /MK /CA 并绘制在外观中 |
返回值
新字段的索引，供其他已加载表单字段方法使用；PageIndex 超出范围时返回 -1
使用注意事项
- 在受影响的页面、资源、字段或 catalog 对象定稿之前，在 AcroForm 工作流中使用该 API
- 在文档定稿之前，保持对象名、字段名、资源名和返回的句柄稳定
- 已加载文档的对象引用可能是间接的；检查嵌套值之前先解析数组、字典或流