PageGoto
Displays a graphics page in the active window. The page needs to be in one of the operator's current areas. You can specify either the Page Name or the Page Number of the graphics page.
You can also specify if the page operates within the context of a particular cluster in a multiple cluster project. When the page launches during runtime, the ClusterName argument is used to resolve any tags that have the cluster name omitted.
This function is similar to PageDisplay(), however PageGoto() does not put the current page onto the PageLast stack.
You cannot call this function from the Exit command field (see Page Properties) or a Cicode Object.
Note: This function is not supported in the server process in a multiprocessor environment. Calling this function from the server process results in a hardware alarm being raised.
Syntax
PageGoto(Page,ClusterName)
Page:
The name or page number of the page to display (in quotation marks ""). Can be prefixed by the name of a host cluster, that is "ClusterName.Page". This will take precedence over the use of the ClusterName parameter if the two differ.
ClusterName:
The name of the cluster that will accommodate the page at runtime (in quotation marks ""). The specified cluster is used to resolve any tags that have the cluster name omitted. If the Page parameter is prefixed with the name of a cluster, this parameter will not be used.
Return Value
0 (zero) if the page is successfully displayed, otherwise an error is returned.
Related Functions
Example
PageDisplay("MIMIC1");
! Displays page "MIMIC1".
PageDisplay("MIMIC2");
/* Displays page "MIMIC2" and places page "MIMIC1" onto the PageLast stack. */
PageGoto("10");
/* Displays page "10". Page "MIMIC2" is not placed onto the PageLast stack. */
Note: Before CitectSCADA version 5.0, page records
could be edited in the Project Editor. One of the fields available
for configuration was "Page Number". The value entered for a page
could then be used in runtime with the Page Cicode functions such
as PageDisplay()
, PageGoto()
, and PageInfo(1)
.
For example, PageDisplay("1")
can
be used to display the page that has "1" (without the quotes) set
in the Page Number field. PageInfo(1)
returns the Page Number of the
current page.
From version 5.0 on, this feature is only backwards-supported. The
"Alias" field in the project Pages.DBF file still contains the Page
Numbers from upgraded projects; however, the Pages database records
are no longer available for direct editing in CitectSCADA.
See Also
Improved Client Side Online Changes