#Page

Top  Previous  Next

The #Page object defines the position and size of the screen page in which the EPAM objects are displayed. The screen page can take on here the size of the entire screen (Full screen) or only part of it (window). The entire screen can also be divided up into subareas (Frames) using several Page objects.

 

Parameters

Object

Column A, object

M/O

Default

Description

#Page=<name>

M


Unique, user-specific <name> of a screen page

Text/File

Column B, Text/File

M/O

Default

Description

<Title>

O

Empty string

Text string as page title (text is centered). The text can be edited or selected via the Add Text context menu from the Text worksheet.

<Title Line1|Title Line2>

O


Multiple-line text. In this case, the text is left-justified.

<Image file>

O


The image file is centered on the page. (background image)

Font

C Font column

M/O

Default

Description

<Fontname>.FNT

O

Current font

optional font for displaying the title text

X, Y, DX, DY

Columns D-G

M/O

Default

Description

Integer constants

O

0

Position and dimension of the screen page

Color

Column H

M/O

Default

Description

Font color

O

0

Font color for the title text

Backcolor

Column I

M/O

Default

Description

Background color

O

0

Background color for the screen page

Format

Column J

M/O

Default

Description

Format

O

No border

Formats to display the screen page

 

Action

Action on a page mainly make sense in the context of gestures. Thus, the actions in the following table may be prefixed with one of the following gestures .

 

gesture:swipe:right:<action>

Swipe gesture to the right

gesture:swipe:left:<action>

Swipe gesture to the left

gesture:swipe:up:<action>

Swipe gesture up

gesture:swipe:down:<action>

Swipe gesture down



Sample:

gesture:swipe:right:#page=info

 

Spalte K

Beschreibung

#Page=<name>

Open page with name <name>

#Page=<name>:animation={topin¦bottomin¦leftin¦rightin}[(<duration>)]

Animated page change:

To open a page with an animation append :animation= to the page name, followed by type of animation:

 


animation=topin

shift the page into the display from top to the destination position


animation=bottomin

shift the page from into the display botton to the destination position


animation=leftin

shift the page from left into the display to the destination position


animation=rightin

shift the page from right into the display to the destination position

 

Sample:

#Page=pw:animation=topin

 

Optionally it's possible to define the duration of the animation. Default ist 600ms.

 

Sample:

#Page=pw:animation=topin( 400 )

 

AlarmList:info=<n>

The page <n> configured in the Alarm definition at Alarm lnfo action of the selected alarm is opened. (1. Action=1, 2.=2,...)

AlarmList:[<name>].info=<n>

Execute <action> on the #AlarmList designated by <name>

Thereby it isn't necessary to set /S/APP/AlarmList:Type.

 


 

Option

Column S

M/O

Default

Description

Page=Dialog

O


This option makes the page modal. In this way, only this page can be operated, and all other pages are disabled until this page has been closed.

ID=<index>

O

0

This option sets the ID of the page and the associated system variables to <index>. The permissible value range for <index> is 0-65536.

Popup

O


Opens the current page as a popup. In other words, all existing pages are retained and the new page is laid as a popup on top of the stack.

A page is normally replaced by a new page if they have the same geometry (size and position) and any overlaid pages above it are closed.

See also Window handling

Transparency=<color>

O


The <color> specified in an image file is interpreted as transparent.

Icon-Hinweis Is only required for image formats that do not support transparency, e.g. PCX

In EPAM4 it is better to use the PNG image format instead of this option.

 


System variables

System variables in conjunction with the #Page object:

 

/S/SYS/PageName
/S/SYS/PageId
/S/SYS/PageIdLast
/S/SYS/NewPage

 

Icon-HinweisTriggering a screen page change in the PLC

The system variable /S/SYS/NewPage and the #Sys2PLC object enable screen changes to be triggered in the PLC.

 


Icon-Hinweis        Frames

A screen page can be divided into different areas (frames) by defining several #Page objects. In this way, it is possible to change screen contents independently of each other in the individual areas. (example: See #Page=ObjectMeter demo project)

This enables global action bars or status indications to be defined at a central point and independently of the page.

 

 Example

 

frames

 

Window handling

Screen pages with different dimensions are superimposed on each other and are displayed and refreshed on screen at the same time (Window handling). All objects remain fully operable if they are visible (exception: Option Page=Dialog). A superimposed screen page can be closed with the close action or close=<name> action if the underlying screen page is larger (DX or DY). The ‘close’ action has no effect if only one visible screen page is active.

If a screen change takes place (#Page=<name> action) to another screen page with the same dimensions, the existing page is deleted and is replaced by the new screen page. Any superimposed pages (windows) are closed.

 

Difference to EPAM3

In EPAM3 objects that are fully or partially covered by a superimposed screen page are designated as invisible and are no longer refreshed. In EPAM4, objects that are fully or partially covered continue to be refreshed (incl. Limit actions) and can be operated if they are visible.
Frame pages are handled in the same way as in EPAM3. However, EPAM3 frame pages have been found to be output incorrectly with an offset (see bug#603). This error has been fixed in EPAM4.
In EPAM3 the image file was always displayed at the top left, EPAM4 centers the image if a border is defined.