ShowPage2
(Display Manager Library)
Description: | Opens the page specified in PageName |
Returns: | Object reference |
Usage: | Script Only. |
Function Groups: | Graphic |
Related to: | StopPage | ClosePopUp | ShowPage |
Format: | \DisplayManager.ShowPage2(PageName[, Popup, PageParms, DisplayRoot, UpdateSamePopup, DisplayIndex]) |
Parameters: |
PageName |
Required. Name of page to be displayed. |
Popup |
Optional boolean. If TRUE, it requests the page be opened as a popup if allowed. Defaults to FALSE. |
PageParms |
Optional. Array of parameters for the Page. |
DisplayRoot |
Optional. Represents the display device instance. |
UpdateSamePopup |
Optional. If the current page is the same as NewPage but with different parms, set this to TRUE to update the current page's parms, or FALSE to open a new popup. Defaults to FALSE. |
DisplayIndex |
Optional integer. In a multi-monitor environment, the index value of the display instance on which the page should be displayed. Defaults to the caller's display index. |
Comments: |
... |
Example:
If we consider a 3x2 multi-monitor environment, when the alarm icon is clicked on any monitor, the AlarmPage will always be displayed on the 3rd monitor.
If IconPressed[#AlarmIcon]; [ { Alarm icon -- switch to alarm page if clicked } \DisplayManager.ShowPage2("AlarmPage" { Name of the page }, FALSE { not a popup }, ParmsArray { page parameters }, GraphicsInstance [Display Device Instance], FALSE [to not update existing page's parameters], 3 { Index of display instance};) ]