Skip to main content
Version: 8.1

system.gui.getDesktopHandles

This function is used in Python Scripting.

Description

Gets a list of all secondary handles of the open desktops associated with the current client. In this case, secondary means any desktop frame opened by the original client frame.

For example, if the original client opened two new frames ('left client' and 'right client'), then this function would return ['left client', 'right client'].

See the Multi-Monitor Clients page for more details.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.gui.getDesktopHandles()

Parameters

Nothing

Returns

List[Any] - A Python list of unicode strings, representing the handle of all secondary desktop frames.

Scope

Vision Client

Code Examples

Example #1 - Getting Desktop Handles
# The following example list all handles (except the main client)
# in the client console (Help -> Diagnostics -> Console)

print system.gui.getDesktopHandles()
Example #2 - Putting Desktop Handles in a Table
# Create the header and fetch handle names
header = ["Desktop Names"]
handleList = system.gui.getDesktopHandles()

# change the handle name list into a column
handleColumn = [[name] for name in handleList]

# display the handle list in a table component
event.source.parent.getComponent('Handles Table').data = system.dataset.toDataSet(header, handleColumn)

Keywords

system gui getDesktopHandles, gui.getDesktopHandles