Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Scripting_function



Panel
titleDescription

When called in a Vision client, it operates exactly like system.nav.openWindow, except that if the named window is already open, then an additional instance of the window will be opened. There is no limit to the number of additional instances of a window that you can open.

New_in
Version8.0.5


When called in the Designer, it operates similar to system.nav.openWindow, except that if the named window is already open the function will swap to the opened window. Additional instances will not be opened. A warning is issued indicating why a new instance was not opened.



Panel
titleClient Permission Restrictions

This scripting function has no Client Permission restrictions.


Panel
titleSyntax

system.nav.openWindowInstance(path [, params])

  • Parameters

String path - The path to the window to open.

PyDictionary params - A dictionary of parameters to pass into the window. The keys in the dictionary must match dynamic property names on the target window's root container. The values for each key will be used to set those properties. [optional]

  • Returns

PyObject - A reference to the opened window. Refer to the list of window objects.

  • Scope

Vision Client



Panel
titleCode Examples


Code Block
languagepy
titleCode Snippet
# This example would open three copies of a single HOA popup screen.
 
system.nav.openWindowInstance("HOA", {machineNum:3})
system.nav.openWindowInstance("HOA", {machineNum:4})
system.nav.openWindowInstance("HOA", {machineNum:5})



Panel
titleKeywords

system nav openWindowInstance, nav.openWindowInstance