Skip to main content

Interface: PushButtonOptions

Options for creating a push-button form field.

Properties

PropertyTypeDescription
actions?FieldActionsJavaScript actions attached to this field's /AA dictionary. Each action value is raw PDF JavaScript source code.
appearance?stringCustom appearance stream content for the push button. Example: "1 0 0 rg 0 0 100 20 re f"
borderWidth?numberAnnotation or field border width in PDF points.
color?ColorInputColor used for drawing, text, or highlighting.
description?stringField description, emitted as /TU (the field's user-facing name). Assistive technology reads it as the field's accessible name, and it satisfies the "form fields have a description" accessibility check.
encrypt?booleanWhether the field value follows document encryption. When false, the field value is not encrypted (useful for searchable fields). Defaults to true (follow document encryption).
font?FontNameFont used to render text.
fontSize?numberFont size in PDF points.
heightnumberHeight in PDF points.
labelstringExplicit list marker or button label text.
readOnly?booleanWhether the form field is read-only.
structure?PdfStructureOptionsAdditional structure metadata for tagged PDF output.
tag?"Annot" | "Artifact"Structure tag used for tagged PDF output.
widthnumberWidth in PDF points.
xnumberHorizontal position in PDF points.
ynumberVertical position in PDF points.