> For the complete documentation index, see [llms.txt](https://docs.apryse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apryse.com/xamarin/viewer/new-document-viewer-ui-x.md). # New Document Viewer UI Discover the new Document Viewer UI in Xamarin.Android with Apryse's Android SDK version 7.1.5! Enhanced features include improved annotation toolbar, multi-tab navigation, stamp and signature flows, {% tabs %} {% tab title="Android" %} ## New Document Viewer UI in Xamarin.Android Starting with Version 7.1.5, Apryse's Android SDK ships with a brand new viewer [`PdfViewCtrlTabHostFragment2`](https://sdk.apryse.com/api/xamarinandroid/tools/api/pdftron.PDF.Controls.PdfViewCtrlTabHostFragment2.html) which includes an updated user interface containing: improvements to the annotation toolbar, a better multi-tab navigation experience, improvements to stamp and signature flows, and more. `PdfViewCtrlTabHostFragment2` is a drop-in replacement for `PdfViewCtrlTabHostFragment` and steps for migrating from the old viewer can be found in migration guides. `PdfViewCtrlTabHostFragment` will continue to use the existing UI, however this will be deprecated in future versions of Apryse. ## Annotation Toolbar The annotation toolbar has been completely revamped in order to accommodate our ever expanding set of tools. The Pan tool bas been removed from the toolbar and the toolbar itself is now scrollable. By default when no tools are selected in the toolbar, the pan tool is selected. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-c5790d629455a6a7c992a2b42e4492c47f0acd23%2F9c4ee5625625f1966fba3f0beff3082a68a7d16e-600x1067.gif?alt=media) ## Annotation Toolbar Switcher In order to help users find the right tool for the job, we've grouped the tools into specific toolbars. For example some new toolbars are: Annotation Toolbar, Draw Toolbar, Fill and Sign Toolbar, Prepare Form Toolbar, Insert Toolbar, Measure Toolbar, and Pens Toolbar. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-e6e77a4bc733fc69e57b89cd5c6105a094be94b4%2Fbfad304bbd895b3138231893ea80d174a0f4c7f5-436x779.png?alt=media) ## Multi-tab Switcher Dialog The tab layout for switching between multiple documents in the viewer has been removed on Phones. Instead a new multi-tab switcher has been added to let users manage their document tabs. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-bab9e3a71d6530bc6791775a5ad5d55a29c61cc4%2F7e18fe60c6cbb6e4a480589051fd596bc18816f7-432x565.png?alt=media) ## Preset Bar A new preset bar has been added to let users quickly switch between styles when creating annotations. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-0372335cca0d60d06137cbcd28f380a29e8bafaa%2F39c8b40266f78fad841a3774db09d55c506d1428-437x49.png?alt=media) ## Bottom Navigation Bar The bottom navigation bar has revamped and provides one-tap access to: the page thumbnail viewer, text search, reading mode, and the annotation/outline/bookmark list. The thumbnail slider has been moved to another part of the viewer, which is described in the next section. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-088616107ea224e96d5f9cefb16016a68bb01337%2Fb327adffd1fa09bd83af3542b16ad1b2e287a40c-436x48.png?alt=media) ## Thumbnail Slider The thumbnail slider will now be shown horizontally above bottom navigation bar if the viewer is in horizontal scroll mode. If the viewer is in vertical scroll mode, the thumbnail slider will now shown vertically along the right edge of the viewer. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-b0cb2f035c84335488416aca60d3c9191f5458c1%2F6e1e492c1662a0298f852b7dbd823926a8c636d0-600x1067.gif?alt=media) ## Edit Toolbars Tools in the annotation toolbars can be arranged by the user to fit their needs. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-d37dba7c2a89a9145fc14c98a2c4d55d2ec58435%2Fc6b20b2c2adabcf6d27fe2c2be923f281f1077f8-435x441.png?alt=media) ## Favorite Toolbar In addition, users can now build their own toolbar from scratch using any one of our annotation toolbar tools. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-726c3a7b4cc3d8c1d5cb2a35f8a2da49797ed94e%2F947aadf0c8b7089b541ea85501c532252cd2587f-435x746.png?alt=media) ## Tablet User Interface For tablet devices, the user interface is slightly modified to better fit the larger screen size. The bottom navigation bar is removed,and the buttons are moved to the toolbar menu, In addition, the preset bar is embedded in the annotation toolbar to make use of the extra space and provide more room to view the document. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-380279bc55be5c7386eb6e346c7fabbf8e8e05e8%2F3715498e49877438954ade8e293acccdf5897e96-674x919.png?alt=media) {% endtab %} {% tab title="iOS" %} ## New Document Viewer UI in Xamarin.iOS Starting with Version 7.1.5 Apryse's iOS SDK, we introduce a new and improved UI for our document viewer: ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-a1d9b56e88c1a8f7f07a5870ddc6d2347c3f0b67%2F5ca895b1de9d25fb4295b8f4f0f426e6c3f90308-600x251.gif?alt=media) The UI is: * Easily customizable by APIs * Provides an excellent UX and attractive UI * Can show annotation tools concurrently with the main UINavigationBar * Accommodates an unlimited number of tools (and toolbars) * Is user-customizable This functionality is part of the new class `PTDocumentController`, which is a near drop-in replacement for `PTDocumentViewController`. ## Annotation Toolbar The annotation toolbar has an attractive look. The toolbar scrolls horizontally, allowing it to host any number of tools. Frequently accessed undo/redo buttons are "sticky", and are always available: ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-e483ff1233f16d662b2f2db57e5458398403ca38%2F038b72c119fd30ee5f8c26b40443b27a5c1f7d43-1659x696.jpg?alt=media) ## Multiple Toolbars Multiple toolbars are supported, and can be switched between using a toolbar chooser. A number of standard toolbars are included, including "View", "Annotate", "Shapes", and "Insert". These are completely customizable, both the name and number of toolbars, which tools they contain, and what order they are displayed in, so that it can fit your app's requirements exactly. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-3ca7603a5f7d8e000a67171f8ae88946fea9a2d8%2F25cc575331d45b765399322b517adde8718db8e5-1668x903.jpg?alt=media) ## View mode The UI also includes a "View Mode", which hides the annotation toolbar. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-ebb3c1210a49258982a92656924e47ae563c1ca0%2Fd072a4879796450d7c620e4bb1ed7487fd1a3f97-1668x608.jpg?alt=media) ## Presets Annotation tools support presets, so that a user can quickly change between styles of the same tool. For example when the pen tool is active, switching from red to green, and then back to red, are both single-tap operations. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-748200f2e31d90dd9c4d61e60eddb9c790c0976b%2Fe58a23f0f802823e6c58fd117ae0d6d228bb5736-600x363.gif?alt=media) ## Bottom Bar On iPhone, the bottom bottom bar includes one-touch access to viewing and navigation actions, which enables single-handed viewing. These actions include the annotation/bookmarks/outlines/layers lists, thumbnails, reader mode and a Safari-inspired tabs button. ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-c4d27bab3fe8d47d1c0456dcdbe07e41f6888181%2F90b70940b6a1af44771a8368af9052aeb18a30c1-1125x2436.jpg?alt=media) Of course, this area is completely customizable for your app's purposes. ## Thumbnail Slider The thumbnail slider moves horizontally or vertically with the direction of scroll. ## User toolbar customization If your app contains many tools, the new UI allows the user to customize it to their preference. This includes the ability to re-order tools in a toolbar: ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-f4464304db36f05ec61dc08f4ec79c63254bca3b%2Fbf06fff5a20e1695e6465fea7e528da7b03733df-1668x2224.jpg?alt=media) As well as create a fully-custom "favorite" toolbar: ![](https://653871032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgjsBtuYmcKhWOdM9VCg4%2Fuploads%2Fgit-blob-ea6f77f869e4d3b8b3f27f3a30fde519b6c5bd25%2F85138dbdb1a930986829f4ae5afcaf5cf0347fd0-1668x2224.jpg?alt=media) {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.apryse.com/xamarin/viewer/new-document-viewer-ui-x.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.