Customize annotation toolbar in Xamarin viewer

The PTAnnotationToolbar class is a UIToolbar consisting of various annotation creation tools. With the annotation toolbar, users are able to conveniently create and switch between different tools.

The annotation toolbar control is part of the Tools library, so make sure you have added it to your project.

Scenario	Annotation Toolbar
Small devices in landscape mode + Tablet devices
Small devices in portrait mode

To create and set up an annotation toolbar, initialize an AnnotationToolbar instance and add it to your view hierarchy:

1var annotationToolbar = new pdftron.PDF.Controls.PTAnnotationToolbar(mToolManager);
2annotationToolbar.AnnotationToolbarDidCancel += (sender, e) =>
3{
4    annotationToolbar.Hidden = true;
5};
6View.AddSubview(annotationToolbar);
7
8// position annotation toolbar
9annotationToolbar.TranslatesAutoresizingMaskIntoConstraints = false;
10NSLayoutConstraint.ActivateConstraints(new NSLayoutConstraint[] {
11    annotationToolbar.LeadingAnchor.ConstraintEqualTo(this.View.LeadingAnchor),
12    annotationToolbar.WidthAnchor.ConstraintEqualTo(this.View.WidthAnchor),
13    annotationToolbar.TopAnchor.ConstraintEqualTo(this.View.LayoutMarginsGuide.TopAnchor)
14});
15
16// hide annotation toolbar by default
17annotationToolbar.Hidden = true;

To show:

1// Show the annotation toolbar.
2annotationToolbar.Hidden = false;

The PTAnnotationToolbar class provides an API for specifying which tools are displayed in the toolbar when there is insufficient space to show them all. This is controlled by the PrecedenceArray property.

The PTAnnotationToolbarDelegate protocol allows the adopting class (usually the containing view controller, as in this guide) to be notified of annotation toolbar events and control the behavior of the toolbar.

1annotationToolbar.AnnotationToolbarDidCancel += (sender, e) =>
2{
3    annotationToolbar.Hidden = true;
4}

By default, the annotation toolbar returns to the pan tool after an annotation is created. If you prefer to stay in the same tool mode after an annotation is created, you should implement the toolShouldGoBackToPan method in your AnnotationToolbarDelegate adopting class:

1mAnnotationToolbar.ToolShouldGoBackToPan = (annotationToolbar) =>
2{
3    return false;
4};

The annotation toolbar's behavior could also be handled within user settings by checking and returning the appropriate settings value in the method above.