Guides

Viewer

The ComPDF Flutter SDK supports multiple viewer event listeners. Below are commonly used viewer events:

Event Name	Description
onPageChanged	Triggered when user turns a page, returns current page index.
onSaveCallback	Triggered when document save completes, returns save result.
onFillScreenChanged	Triggered when user toggles to fullscreen, returns fullscreen status.
onTapMainDocAreaCallback	Triggered when user taps the PDF page area.
onPageEditDialogBackPress	Triggered when user clicks back button in page edit dialog.
onIOSClickBackPressed	iOS: triggered when user clicks top-left back button in CPDFReaderWidget.

To listen to these events, pass the corresponding callback functions when creating CPDFReaderWidget. For example:

CPDFReaderWidget(
  document: documentPath,
  configuration: configuration,
  onCreated: (controller) {},
  onPageChanged: (int pageIndex) {
    debugPrint('Current page: $pageIndex');
  },
  onSaveCallback: () {
    debugPrint('Document saved successfully');
  },
  onFillScreenChanged: (bool isFullScreen) {
    debugPrint('Is full screen: $isFullScreen');
  },
  onTapMainDocAreaCallback: () {
    debugPrint('Main document area tapped');
  },
  onPageEditDialogBackPress: () {
    debugPrint('Back button pressed in page edit dialog');
  },
  onIOSClickBackPressed: () {
    debugPrint('iOS back button pressed');
  }
);