Customizing the PDF Editing Toolbar UI in iOS
The Document Editor toolbar holds a set of buttons that can be used to perform document editing actions. Some of the buttons are context-sensitive and are enabled only on demand, based on factors such as the selection state in the document view. See the Actions section for a detailed description of all the actions you can perform with these buttons.
The toolbar can be moved to different positions onscreen using the drag handle on the right (or bottom) side of the toolbar.
In addition to the drag-and-drop action, which you can perform directly on the document view, there are many other actions you can perform using the Document Editor toolbar.
The following table lists all the toolbar buttons:
|New||Shows the new page creation user interface|
|Remove||Removes the currently selected pages from the document|
|Duplicate||Creates copies of currently selected pages|
|Rotate||Rotates the selected page 90 degrees clockwise, and can be invoked multiple times|
|Export||Shows the export user interface that allows the selected pages to be saved as a new document|
|Select||Toggles between selecting and deselecting all pages|
|Copy||Puts the selected pages in the clipboard|
|Paste||Pastes pages from the clipboard, inserting them at the selected location or end of the document|
|Undo||Undoes the last document editing action|
|Redo||Redoes the last undone document editing action|
|Done||Exits document editing, prompting to save changes if needed|
The first toolbar button allows you to create new pages, which are inserted at the end of the document.
You can configure several properties for new pages, including the background, background color, and size. The page background can be blank, one of the predefined patterns, or a custom image from your Photo Library. The Page Color selector includes both a set of common colors and a full color picker to select any color you desire. To switch between the two selection modes, swipe left or right when picking colors. The page size can be either one of the standard paper sizes or a size that matches the main page size of the current document. You can also opt for the new page to be oriented vertically or horizontally.
The export toolbar action allows you to create a new document comprised of the pages selected in the document view. This action doesn’t modify the current document in any way. When it’s selected, you’ll be presented with a dialog where you can name the new PDF file and optionally select its location.
Document editing changes aren’t persisted until an explicit save is performed. This means you can easily exit your document editing session without modifying the document by selecting Done and opting to Discard Changes.
If you want to save your changes, you generally have two options. You can save the changes to the existing document by selecting Save, or you can save the changes to a new file using Save As… The Save option might not be available for some types of documents (e.g. read-only documents). In that case, only the Save As… option will be displayed.
If you decide to save the changes as a new document, you can select Save As…, and a new dialog will be displayed. This will allow you to name the new document and optionally select its location. Selecting Save will complete the save and create the new PDF file.