system.gui.getDesktopHandles
note
This function was deprecated in 8.3 and replaced with a system.vision
variation.
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)