THotPDF.AddLoadedPushButton Method

Adds a push button to a page of the loaded document and registers it in the AcroForm. The appearance stream draws ACaption centered in the button

Declaration

function AddLoadedPushButton(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, ACaption: AnsiString): Integer;

HPDFDoc

Name	Purpose
`PageIndex`	Zero-based index of the loaded page that receives the widget
`X1`	Left edge of the widget rectangle in PDF user space (points, origin at the bottom-left corner of the page)
`Y1`	Bottom edge of the widget rectangle in PDF user space
`X2`	Right edge of the widget rectangle in PDF user space
`Y2`	Top edge of the widget rectangle in PDF user space
`AFieldName`	Name of the new field; it must not already exist in the loaded form
`ACaption`	Button caption, stored in /MK /CA and drawn in the appearance

Index of the new field, for use with the other loaded form field methods, or -1 when PageIndex is out of range

Use this API in the AcroForm workflow before the affected page, resource, field, or catalog object is finalized
Keep object names, field names, resource names, and returned handles stable until the document is finalized
Loaded-document object references may be indirect; resolve arrays, dictionaries, or streams before inspecting nested values