Cicode Programming Reference > Cicode Function Categories > Page Functions > PageLast

PageLast

Displays the graphics page that was last displayed. With this function, you can successively recall the last ten pages that were displayed.

Graphics pages displayed using this command cannot be subsequently recalled.

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

PageLast()

Return Value

0 (zero) if the page is successfully displayed, otherwise an error is returned.

Related Functions

PagePeekLast, PagePopLast, PagePushLast

Example

Buttons

Text

Last Page

Command

PageLast()

Comment

Display the graphics page that was last displayed

PageDisplay("MIMIC1");
! Displays page "MIMIC1".
PageDisplay("MIMIC2");
/* Displays page "MIMIC2" and places page "MIMIC1" onto the page navigation history. */
PageDisplay("10");
! Displays page "10" and places page "MIMIC2" onto the page navigation history. */
PageLast();
/* Displays the last page, that is page "MIMIC2" and removes it from the page navigation history. */
PageLast();
/* Displays the last page, that is page "MIMIC1" and removes it from the page navigation history. */
PageLast();
/* Returns an "Out of range" error code as there are no more pages in the page navigation history.*/

See Also

Page Functions

Published June 2018