Customize a document view controller on iOS

This article explains how to customize the document viewer classes PTDocumentController and PTTabbedDocumentViewController.

Because the document viewer classes are part of the open source Tools UI framework, it is possible to achieve virtually any required modification. That said, it is usually faster and more convenient to configure the viewers via APIs, which this guide describes.

On iPad and other regular horizontal size class devices, a number of default UI controls are accessible from the navigation bar, whereas on iPhones and compact size classes some of those controls appear in the toolbar at the bottom of the view.

The toolbar switcher can be hidden:

Toolbars can be removed by removing them from the toolGroupManager's groups array. The following code removes the "Draw" and "Pens" toolbars:

The buttons which are contained in the leftBarButtonItems and rightBarButtonItems arrays, are completely customizable. It is possible to

You can modify the navigation bar items. Here is an example of adding a new button (for the current size class):

Tools can also be added:

Note that in the example above, de-selecting the tool button item needs to be implemented by the app, by listening to the Tool Did Change notification.

To remove any of the default buttons see the instructions here: Hide default buttons

The default buttons are all accessible via properties, making it easy to rearrange or move them. The following code swaps the position of the search button and navigation lists button:

The icons of existing buttons may be changed by creating new UIBarButtonItems that have the same target and action as an existing item, and replacing the existing item with the new item:

The currently-visible annotation toolbar is selected with the toolbar switcher.

The toolbar can be programmatically hidden by setting the mode to view group, which is a special group and the only group where the toolbar is hidden:

The toolbar can be shown again by changing the group to any group other than view:

The example below shows how to remove the text highlight and text underline button from a toolbar.

Disabling a tool type entirely

If you want to disable a tool entirely, from all toolbars and the long press menu, please use the annotations permissions system.

Your app may need a button that does not invoke one of the built in annotation tools. The following code will add a button that calls a selector.

If you want to toggle the items selection, flip its selected property:

The page indicator can be enabled/disabled via the pageIndicatorEnabled property.

The PTPDFViewCtrl is a UIView that displays the PDF. It is customizable via is properties/methods and delegate methods.

For an overview see the PTPDFViewCtrl Guide , or the detailed API documentation.

Note that all PDF "interaction" (annotations, form filling, text selection, link following, etc.) is supplementary to the PDFViewCtrl, and is implemented in the open source tools.framework.

These are the buttons that appear at the bottom of the screen on iPhones and in Compact horizontal size classes. Buttons can be added, removed, or rearranged with convenient APIs.

To remove any of the default buttons see the instructions here: Hide default buttons

To customize the controls that are presented by the PTDocumentController's default buttons, please see the corresponding guide or API:

Default buttons can be removed ("hidden") using built-in properties.

For example to hide the search and more items buttons:

The tabbed document view controller displays a collection of document controllers in tabs.

Tabs can be disabled using the tabsEnabled property, and the maximum number of allowed tabs can be set using maximumTabCount.

The current document controller can be accessed via selectedViewController, and others via documentViewController(at:)

To configure a document controller before it is displayed, conform to and implement the PTTabbedDocumentViewControllerDelegate method tabbedDocumentViewController(_:willAdd:). Note that it is permissible to assign the internal PTDocumentViewController's delegate to an external object.