Customize annotation interactions in Xamarin.Android viewer

You will need to use ToolManager for PDF interaction tools to work. You can build it easily using ToolManagerBuilder, a helper class for configuring and creating ToolManager. It also sets ToolManager to a specific PDFViewCtrl.

To build a default ToolManager, use ToolManagerBuilder and pass in an instance of PDFViewCtrl:

var mToolManager = pdftron.PDF.Config.ToolManagerBuilder.From()
    .Build(this, mPdfViewCtrl);

You can customize the ToolManager programmatically with ToolManagerBuilder:

var mToolManager = pdftron.PDF.Config.ToolManagerBuilder.From()
    .SetEditInk(true)
    .SetOpenToolbar(true)
    .SetBuildInPageIndicator(false)
    .SetCopyAnnot(true)
    .DisableToolModes(new ToolManager.ToolMode[]{
        ToolManager.ToolMode.TextAnnotCreate,
        ToolManager.ToolMode.TextCreate,
        ToolManager.ToolMode.TextSquiggly,
        ToolManager.ToolMode.InkEraser,
        ToolManager.ToolMode.FormCheckboxCreate,
        ToolManager.ToolMode.RectCreate,
        ToolManager.ToolMode.TextLinkCreate
    })
    .Build(this, mPdfViewCtrl);

Image stamps and image signatures require a source image in order to create the annotation. If you are using PDFViewCtrl with ToolManager, will need to handle this manually in your app by implementing the methods ToolManager.AdvancedAnnotationListener.imageStamperSelected(PointF) and ToolManager.AdvancedAnnotationListener.imageSignatureSelected(PointF, int, Long).

For reference you can check out our PDFViewCtrl integration guide here

You can also customize the ToolManager by defining an Android style resource and passing it to ToolManagerBuilder:

1. Create a custom style in your res/values/styles.xml file:

   <style name="MyToolManager">
       <!-- allow editing ink annotations (only works if annotation toolbar is present) -->
       <item name="edit_ink_annots">true</item>
       <!-- when ink selected in annotation toolbar, it should open its own ink toolbar -->
       <item name="open_toolbar_on_pan_ink_selected">true</item>
       <!-- hide the built-in page number indicator -->
       <item name="build_in_page_number_indicator">false</item>
       <!-- whether to copy marked-up text of TextMarkup annot to annotation's 'content' property upon TextMarkup annotation creation -->
       <item name="copy_annotated_text_to_note">true</item>
       <!-- remove some tools from AnnotationToolbarComponent and QuickMenu -->
       <item name="disable_tool_modes">@array/disable_tool_modes</item>
   </style>

   For additional customization, a list of supported style attributes are defined in this table.

2. In the previous step, @array/disable_tool_modes is a string array defining tool modes that should be disabled. You can define it in res/values/arrays.xml:

   <?xml version="1.0" encoding="utf-8"?>
   <resources>
       <string-array name="disable_tool_modes">
           <item>TEXT_ANNOT_CREATE</item>
           <item>TEXT_CREATE</item>
           <item>TEXT_SQUIGGLY</item>
           <item>INK_ERASER</item>
           <item>FORM_CHECKBOX_CREATE</item>
           <item>RECT_CREATE</item>
           <item>TEXT_LINK_CREATE</item>
       </string-array>
   </resources>

   Each <item> in the array needs to be a string matching one of the enum values from ToolManager.ToolMode.

   You can also set up ToolManagerBuilder programmatically. For a list of settings available, see the ToolManagerBuilder API.

3. Lastly, build the ToolManager using ToolManagerBuilder and pass in your custom style and an instance of PDFViewCtrl:

   var mToolManager = pdftron.PDF.Config.ToolManagerBuilder.From(this, Resource.Style.MyToolManager)
       .Build(this, mPdfViewCtrl);

   Alternatively, you can pass the ToolManager style resource directly to ViewerConfig.Builder. You can learn more about configuring ToolManager with ViewerConfig in the viewer configuration guides.