You're currently browsing the Ignition 7.9 docs. Click here to view the latest docs.

This function is used in Python Scripting.


Allows for invoking system.nav functions on a specific desktop

See the Multi-Monitor Clients page for more details.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.



  • Parameters

String handle - The handle for the desktop to use. The screen index casted as a string may be used instead of the handle. If omitted, this will default to the Primary Desktop. Alternatively, the handle "primary" can be used to refer to the Primary Desktop.

  • Returns

INavUtilities -  A copy of system.nav that will atler the desktop named by the given handle.

  • Scope


Code Examples
Code Snippet
# The following example will close a window at path "Main Windows/Overview" in the Primary Desktop, 
# regardless of where the script originates from. 
system.nav.desktop().closeWindow("Main Windows/Overview")
Code Snippet
# Attempts to swap to a window at path "Main Windows/Main Window" on a specific Desktop. This example assumes a desktop with the handle "2nd Desktop" is already open.  
system.nav.desktop("2nd Desktop").swapTo("Main Windows/Main Window")
  • No labels