Add a PDF Viewer Add-On Graphic to a screen or popup

PDF Viewer Add-On Graphics contain a PDF graphic element and the predefined commands for navigating and zooming the PDF document on the HMI device. Add the PDF Viewer Add-On Graphic and specify the PDF document that opens on the HMI device.
Prerequisites
  • Create bookmarks for the PDF document prior to adding the PDF document in
    View Designer
    .
To Add a PDF Viewer Add-On Graphic to a screen or popup
  1. In the
    Toolbox
    , expand the
    Add-On Graphics
     category and double-click a PDF Viewer Add-On Graphic:
    • PDF_Viewer.
       Occupies the entire screen on a seven-inch or nine-inch HMI device.
    • PDF_Viewer_Landscape.
       Occupies the entire screen on a 10-inch HMI device and a portion of larger HMI devices. The PDF_Viewer_Landscape Add-On Graphic is not available on seven-inch or nine-inch HMI devices.
    • PDF_Viewer_Portrait.
       Occupies half of the screen on a 10-inch HMI device. The PDF_Viewer_Portrait Add-On Graphic is available on 10-inch or larger HMI devices.
      TIP:
      Tips:
      • Each screen has a limit of displaying two PDF documents. This includes both PDF Viewer Add-On Graphics and PDF graphic elements.
      • PDF documents on the HMI device support internal links for navigation within the PDF document. PDF documents on the HMI device do not support external links. PDF links cannot navigate outside of the PDF document on the HMI device.
      • PDF files that contain complex drawings take longer to render. For example, if a PDF document contains an image comprised of individual shapes such as lines, circles, and rectangles, that image takes longer to render than a drawing that is a single image.
  2. In the
    Properties
    window, expand the
    General
    category.
  3. Configure the required properties:
    • DocumentName
      - The PDF document shown on the HMI device. Select the PDF document for the Add-On Graphic.
    • PageNumber
       - Type the page number of the PDF document to initially open on the HMI device.
    • Zoom
       - Select the zoom factor.
      TIP:
      Tips:
      • Add a PDF Viewer Add-On Graphic to a screen or popup from the
        Project Explorer
         by expanding the
        Assets > Add-On Graphics
         folders and then dragging the PDF_Viewer Add-On Graphic or right-clicking the PDF_Viewer Add-On Graphic and selecting
        Add Add-on Graphic to (screen name)
        .
      • Adding a PDF document from the
        Assets > Documents
         folder of the
        Project Explorer
         opens the
        Select PDF Viewer
         dialog box to select the PDF Viewer or PDF graphic element to display the PDF graphic element on the HMI device. If the definition of an Add-On Graphic contains only one PDF graphic element that has an alias for the DocumentName property of the PDF graphic element, that Add-On Graphic appears in the
        Select PDF Viewer
         dialog box.
      • Do not rotate the PDF graphic element or a PDF Viewer Add-On Graphic. Rotating an element containing a PDF document reduces the clarity of content in the PDF document and prevents zooming and navigating the PDF document on the HMI device.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal