Guides

Forms

Use these callbacks and events to synchronize form property panels and observe form-field creation and selection.

Callback or event	Event data	Trigger
onFormStyleDialogDismissedCallback	CPDFFormType type	The form properties panel closes.
CPDFEvent.formFieldsCreated	CPDFWidget	A form field is created.
CPDFEvent.formFieldsSelected	CPDFWidget	A form field is selected.
CPDFEvent.formFieldsDeselected	CPDFWidget?	A form field is deselected.

void _onReaderCreated(CPDFReaderWidgetController controller) {
  controller.addEventListener(
    CPDFEvent.formFieldsCreated,
    (widget) => debugPrint('Created: $widget'),
  );
  controller.addEventListener(
    CPDFEvent.formFieldsSelected,
    (widget) => debugPrint('Selected: $widget'),
  );
  controller.addEventListener(
    CPDFEvent.formFieldsDeselected,
    (widget) => debugPrint('Deselected: $widget'),
  );
}

CPDFEvent currently covers creation and selection state. It does not report form updates and deletions, or save failures. Custom handling for form-field taps is covered in Custom Annotation Creation Workflows.