---
title: "system.gui.getDesktopHandles"
description: "Gets a list of all secondary handles of the open desktops associated with the current client."
---

# system.gui.getDesktopHandles

> Gets a list of all secondary handles of the open desktops associated with the current client.

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. 

Example: If the original client opened 2 new frames ('left client' and 'right client'), then this function would return ['left client', 'right client']

See the [Multi-Monitor Clients](clients\multi-monitor-clients.md) page for more details.

## Client Permission Restrictions
This scripting function has no [Client Permission](projects\project-properties\project-properties.md#client---permissions) restrictions.

## Syntax
`system.gui.getDesktopHandles()`

### Parameters
None
### Returns
**PySequence** - A list of window handles of all secondary Desktop frames.
### Scope
Client

## Code Examples
```python title="Example #1"
# The following example list all handles (except the main client)
# in the client console (Help -> Diagnostics -> Console)
print system.gui.getDesktopHandles()
```

```python title="Example #2"
# 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)
```