Using the Viewer

Using the ICEpdf Viewer

This section describes how to use the ICEpdf Viewer application to do the following:

• Open PDF files
• Understand the ICEpdf Viewer work area
• Navigate and manipulate the view of a PDF document
• Document Manipulation
• Keyboard and Mouse Manipulation
• Searching for Text
• Working with Annotations
• Displaying Document Permissions and Information
• Export, save, and print the contents of a PDF document
• Exit a document and the application

Opening PDF Files

You can open a PDF file from the local file system or from a URL.

To open a local PDF file

1. Launch your ICEpdf application (if it is not already running).
2. Click File > Open > File (in the menu).
3. In the Open dialog box, select a PDF file and click Open.

To open a PDF from a URL

1. Launch ICEpdf.
2. Select File > Open > URL (in the menu).
3. In the Open URL dialog box, type the URL of a PDF file in the form
   http://www.icepdf.org/resources/DevelopersGuide.pdf and click OK.

To open a PDF using Drag and Drop

You can open a PDF file by dragging it from your file system onto the Viewer application window. You can also drag and drop multiple files at once.

Furthermore, some applications allow you to drag and drop URL text strings. If you drag a URL pointing to a PDF file onto the Viewer application, that file is opened. The text string must contain an http:// prefix and a *.pdf reference.

Note If a file is password protected and security support has been configured, a password dialog is displayed. You have three attempts to enter the correct password, after which an error message is displayed. If the file has other security settings, such as "No Printing", the ICEpdf Viewer respects those settings.

Opening Multiple PDF Files

The ICEpdf Viewer implements a Single Document Interface (SDI) for viewing PDF files. Multiple PDF files can be viewed at the same time, each in its own application window. Some MDI functionality has been included in the Window menu, which allows the user to switch between each open Viewer window, minimize all Viewer windows, and bring all Viewer windows to the front.

An additional ICEpdf Viewer window is opened automatically when you open another PDF file.

back to top

The ICEpdf Viewer Work Area

The ICEpdf Viewer consists of the following four distinct work areas:

1. Main toolbar - provides controls and buttons to navigate and work with a PDF file.
2. Document pane - displays a PDF file.
3. Utility pane - has a bookmark tab which lets you browse a PDF file using a documents bookmarks, search tab which enables you to search for text in a file, layers tab for manipulation of optional content, thumbnail view and annotation tab panel for editing and creating annotations.
4. View toolbar - allows you to change the way a document's pages are displayed in the document pane.

Figure 2 ICEpdf Viewer Work Area

Unable to render embedded object: File (viewer_sm.png) not found.

Main Toolbar

The toolbar has shortcuts for many common functions, but you can hide it to have a larger display area. To show or hide the toolbar, select View > Show Toolbar or View > Hide Toolbar. The toolbar provides access to the view and navigation functionality.

Figure 3 ICEpdf Main Toolbar

Unable to render embedded object: File (toolbar.png) not found.

From left to right, the toolbar contains:

View Toolbar

The view toolbar contains four buttons that allow you to change how a PDF document is displayed.
Unable to render embedded object: File (pageviews.png) not found.
From left to right:
* Facing Page View Continuous
* Facing Page View Non-continuous
* Single Page View Continuous
* Single Page View Non-continuous

About the Utility Pane

You can show or hide the utility pane, which contains tabs for a document's bookmarks, search, thumbnails, layers and annotation functionality. If the file does not have any bookmarks, the bookmarks tab is not displayed.
To show or hide the utility pane, select View > Show Utility Pane or View > Hide Utility Pane. Alternatively, if the toolbar is displayed, you can click the Show/Hide Utility Pane button.

The utility pane can not be hidden if the Annotation Select Tool is selected.

back to top

Navigating Within a PDF File

Using Bookmarks

If a PDF file has been created with bookmarks, you can use the bookmarks like a table of contents to choose what you want to view.
Bookmarks are displayed on a tab in the utility pane on the left side of the Viewer. However, they are not displayed if View > Hide Utility Pane has been selected.

Viewing a Bookmark Topic

To view a bookmark topic, click the bookmark topic name:
Unable to render embedded object: File (bookmarks_sm.png) not found.

Viewing More Bookmark Topics

If a bookmark has a + symbol beside it, you can expand a parent bookmark topic to reveal its children. Similarly, click the - symbol next to a bookmark to collapse a parent bookmark and hide its children.
Unable to render embedded object: File (bookmarks_view.png) not found.

Viewing the Next or Previous Page

* To view the next page of a PDF file, select Document > Next Page.
* To view the previous page of a PDF file, select Document > Previous Page. Using the toolbar, select the Next Page or Previous Page buttons to navigate.
Unable to render embedded object: File (paging.png) not found.

Viewing the First or Last Page

* To view the first page of a PDF file, select Document > First Page.
* To view the previous page of a PDF file, select Document > Last Page. Using the toolbar, select the First Page or Last Page buttons to navigate.
Unable to render embedded object: File (paging.png) not found.

Viewing a Specific Page

To view a specific page of a PDF file:
1. Select Document > Go To Page.
Unable to render embedded object: File (gotopage.png) not found.
2. In the Go To Page dialog, select a page number and click OK.
Using the toolbar, type a page number in the page number field and press Enter.
Unable to render embedded object: File (bookmarks_view.png) not found.
top

back to top

Document Manipulation

Zooming In and Out

You can zoom in on a page to get a closer view, and you can zoom out for a smaller view:
* To zoom in on a page, select View > Zoom In. You can zoom in repeatedly to get a closer view.
* To zoom out from a page, select View > Zoom Out. You can zoom out repeatedly to get a smaller view.
Using the toolbar, select the Zoom In or Zoom Out buttons. You can select a magnification percentage from the Zoom drop-down selection box, or type a value in the Zoom box and press Enter.
Unable to render embedded object: File (zoom_select.png) not found.

Marquee Zoom

Select an area to zoom in on by clicking and dragging to draw the desired selection box. When the mouse button is release the zoom will be change to the appropriate zoom to match the selected area.
Unable to render embedded object: File (zoom_tool.png) not found.

Dynamic Zoom

Dynamic zoom is enabled when the mouse wheel or touch scroll area is scrolled up or down. Scrolling the mouse wheel up will zoom in and out if moved down.
Unable to render embedded object: File (zoom_tool.png) not found.

During the use of any view tool the ctr key can be used in combination with to mouse wheel to provide a zoom in/out tool.

Viewing a PDF File in its Original Size or to Fit the Window

* To view the PDF file in its actual size, select View > Actual Size. The actual size is the size of the page as it was originally created.
* To view the PDF file so that the entire page is visible, select View > Fit in Window.
* To view the PDF file so that the width of the page fills the window size, select View > Fit Width.
Using the toolbar, click the Actual Size, Fit in Window, and Fit Width buttons.
Unable to render embedded object: File (page_fit.png) not found.

Rotating a PDF File

If the PDF file is displayed sideways, you can rotate it so that it is easier to view or read.
To rotate the PDF file, select View > Rotate Left or View > Rotate Right. The view is rotated 90 degrees clockwise or counter-clockwise each time you select it. Using the toolbar, click the Rotate Left and Rotate Right buttons.
Unable to render embedded object: File (page_rotation.png) not found.

back to top

Keyboard and Mouse Manipulation

While viewing a PDF, you can use the following keyboard and mouse actions:

back to top

Searching for Text

If a PDF file contains text, you can search for text strings within it using the Search function.
The Search function is displayed on a tab in the utility pane on the left side of the Viewer. However, it is not displayed if the Utility Pane is hidden. In this case, select Document > Search or click the Search Document button to open the Search tab.

Unable to render embedded object: File (search.png) not found.

To search for a text string, type it in the Search Text field and click Search. The results are displayed in the Results field, indicating how many hits were found on each page of the document. You can then click on an entry in the Result field to go directly to that page.

back to top

Working with Annotations

The Viewer RI is able to display and add / edit / remove Link annotations from a PDF document.
To view, edit, or delete an existing annotation, first use the Select Tool to select an existing annotation. Once an annotation is selected:
* It's properties will be displayed in the Annotations pane of the Utility Panel. These can be edited directly in the Annotations pane.
* It can be moved via dragging it to a new location on the page with the mouse.
* It can be deleted/removed by pressing the Delete key, or the Ctrl-D / Cmd-D key (OS X).
Unable to render embedded object: File (annotation.png) not found.
To create a new annotation, use the Link Annotation Tool. With the tool selected, the mouse can be used to select a rectangular region on the page that will form the extent of the new link annotation. Once the region is defined, the Annotations pane in the Utility Panel can be used to define its attributes.

back to top

Displaying Document Permissions and Information

To display security information about an open PDF document, such as the security method and which security features are enabled, select File > Document Permissions.
Unable to render embedded object: File (permission.png) not found.
To display other information about an open PDF document, such as the creator and modification dates, select File > Document Information.
top

back to top

Exporting a PDF File to SVG

SVG support is available if you have configured the optional Batik SVG library. For more information, see *[Batik Library for SVG Support]*.

To export a PDF file as an SVG file

1. If Batik is configured, select File > Export SVG.
2. In the Export as SVG dialog, specify a location and filename and click OK.

back to top

Exporting a PDF File to Text

You can export the text in a PDF to a text file.

To export a PDF file as a text file:

1. Select File > Export Text.
2. In the Export Document Text dialog, specify a location and filename and click OK.

back to top

Printing a PDF File

To print a PDF file with a printer dialog, select File > Print.

Alternatively, from the toolbar, click the Unable to render embedded object: File (print.png) not found. (Print button) to print a PDF file without displaying a print dialog.

To set the paper, orientation and margin settings before printing the file, select File > Print Setup.

back to top

Saving a PDF File

To save a copy and any annotation related changes of the PDF file you are viewing:

1. Select File > Save As.
2. In the Save As dialog box, navigate to a location for the file, type a unique filename and click OK.

Alternatively, from the toolbar, click the Unable to render embedded object: File (save.png) not found. (Save button) to save a PDF files changes.

back to top

Closing a PDF File

To close the PDF file you are viewing, leaving the application open, select File > Close.

back to top

Exiting the ICEpdf Viewer Application

To exit from the ICEpdf Viewer and close any open files, select File > Exit.

back to top