PDF graphic element

Use the PDF graphic element in the
System
category in the
Toolbox
to open and view a PDF, or add a PDF to a screen, popup, or Add-On-Graphic to display a PDF on the HMI device
Unique Properties
Unique properties are properties that not all graphic elements in the
Toolbox
share.
Name
Category
Purpose
Accepted Values
DocumentName
General
Displays the name of the currently viewed PDF.
Any listed PDF document.
PageCount
General
Displays the number of pages in the PDF.
Read-only
PageNumber
General
Displays the page number currently being viewed. It also specifies the page that is shown when the screen containing the PDF opens.
Tip:
 Writing to this property at runtime changes the page shown in the PDF.
Any positive number. If the PDF has not been loaded, the value of the property is 1.
Zoom
General
Displays the current zoom value used in the PDF. It also specifies the zoom magnification value used in the PDF Viewer when the screen containing the PDF opens.
Tip:
 Writing to this property at runtime changes the zoom magnification value used in the PDF Viewer.
  • Fit Height
  • Fit page
  • Actual size
BackgroundColor
Appearance
Specifies the background color of the PDF.
Any selected color in the Color Picker or a Hex color value entered manually. The Hex value must be in the format #RRGGBB. R, G, and B are Hex digits from 0 through F and represent the color channel values for red, green, and blue. For example, 3ffff00 produces yellow.
Bookmarks
Bookmark
Displays the bookmarks in a PDF document.
Read-only
BookmarkIndex
Bookmark
Displays the bookmark index to display in runtime.
The value of the property is 0.
Common Properties
Common properties exist for all graphic elements.
Property
Category
Purpose
Accepted Values
Access
Security
Specifies if all users have access to the control element, or if access is inherited from the screen.
  • Inherit - Access inherited from screen.
  • Full Access - Access granted to all users.
Angle
Position and Size
Specifies the rotation angle.
Enter 180 to display the graphic element upside down. If you enter a value larger than 360, the portion of numeric value that is over 360 becomes the value. For example, enter 380 to see a value of 20. If you enter a value less than 0, the negative value is subtracted from 360. For example, enter -30 to see a value of 330.
  • Numbers 0 to 360
Enabled
Appearance
Specifies if the graphic element is available on the HMI device and if the graphic element accepts touch and key input.
  • Enabled - selected
  • Not Enabled - cleared
Height
Position and Size
Specifies the height in pixels.
Any positive numeric value
Opacity
Appearance
Specifies the transparency of the graphic element.
0 (fully transparent) - 100 (fully opaque)
Visible
Appearance
Specifies if the graphic element is visible on the HMI device.
  • Visible - selected
  • Not visible - cleared
Width
Position and Size
Specifies the width in pixels.
Any positive number
X
Position and Size
Specifies the horizontal coordinate, in pixels, from the upper left corner of screen to the upper left corner of a graphic element or group with no rotation. If the graphic element or group is rotated, the X property value does not change.
Any positive number
Y
Position and Size
Specifies the vertical coordinate, in pixels, from the upper left corner of screen to the upper left corner of a graphic element or group with no rotation. If the graphic element or group is rotated, the Y property value does not change.
Any positive number
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal