Annotation Events and Notifications

PSPDFKit allows you to edit and create annotations if your license includes this component. You can detect changes to the underlying data models by listening to the following notifications.

Notification Description
.PSPDFAnnotationsAdded Sent when new annotations are added to the default PDFFileAnnotationProvider. Object posting is an array of new Annotation(s).
.PSPDFAnnotationsRemoved Sent when new annotations are removed from the default PDFFileAnnotationProvider. Object posting is an array of removed Annotation(s).
.PSPDFAnnotationChanged Internal events to notify the annotation providers when annotations are being changed. Send only from main thread. Don’t call save during a change notification.

Here’s an example of listening to changes of the contents in the note annotation controller:

// Start listening to the annotation's change notification.
NotificationCenter.default.addObserver(self, selector: #selector(annotationChangedNotification(notification:)), name: .PSPDFAnnotationChanged, object: nil)

func annotationChangedNotification(notification: Notification) {
    // Check if we need to rerender ourselves.
    let changedAnnotation = notification.object as! Annotation
    if annotation == changedAnnotation, let keyPaths = notification.userInfo?[PSPDFAnnotationChangedNotificationKeyPathKey] as? [String] {
        if keyPaths.count > 1 || keyPaths.first != "contents" {
            updateImage(animated: true)
        }
    }
}
// Start listening to the annotation's change notification.
[NSNotificationCenter.defaultCenter addObserver:self selector:@selector(annotationChangedNotification:) name:PSPDFAnnotationChangedNotification object:nil];

- (void)annotationChangedNotification:(NSNotification *)notification {
    // Check if we need to rerender ourselves.
    if ([self.annotation isEqual:notification.object]) {
        NSArray *keyPaths = notification.userInfo[PSPDFAnnotationChangedNotificationKeyPathKey];
        if (keyPaths.count > 1 || ![keyPaths.firstObject isEqual:@"contents"]) {
            [self updateImageAnimated:YES];
        }
    }
}

In PSPDFKit, annotations are usually created using AnnotationStateManager. If you create a drawing, the state manager is in the draw mode and will cache drawn lines until you exit the draw state, which will, in turn, cause an InkAnnotation object to be created. After creation, an undo operation will remove the entire annotation — but while you’re in the drawing mode, undo/redo operates on a finer level, affecting one stroke at a time.

If you change annotations, make sure to also post appropriate change notifications. See our guide on the annotation object model for details.