# Listers

The **Listers** object is a collection of all currently open [Listers](https://chaoses-ib.gitbook.io/directory-opus/manual/basic_concepts/the_lister). It can be obtained via the [**DOpus**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/dopus)**.listers** property.

**Note:** If you are looking for a window to use as the parent for a **Dialog**, you are probably looking in the wrong place. Scripts should not assume that **DOpus.listers(0)** or **DOpus.listers.lastactive** are the lister which launched them. Most scripting events provide you an object which can either create a pre-configured **Dialog** for you or which includes a **SourceTab** property or similar which can do the same. In almost all situations you should use those instead.

| Property Name      | Return Type                                                                                                                           | Description                                                                                                                                                                                                                                                         |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *\<default value>* | *collection:*[**Lister**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/lister) | <p>Lets you enumerate the currently open Listers.</p><p>Do not assume that <strong>DOpus.listers(0)</strong> is the window which launched your script. See the note near the top of the page.</p>                                                                   |
| lastactive         | *object:*[**Lister**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/lister)     | <p>Returns a \*\*<a href="lister">Lister</a>\*\*object representing the most recently active Lister window.</p><p>Do not assume that <strong>DOpus.listers.lastactive</strong> is the window which launched your script. See the note near the top of the page.</p> |

| Method Name | **Arguments**                       | Return Type | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------- | ----------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ToFront     | <p>\<lister><br>\[\<lister>...]</p> | *none*      | Moves one or more Lister windows to the front. This method accepts one or more arguments; each argument can either be a [**Lister**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/lister) object or a [**Vector**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/vector) of [**lister**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/lister) objects. The last window will placed on top, and all others will be below that in reverse order. |
| Update      | *none*                              | *none*      | The first time a script accesses the **DOpus.listers** property, a snapshot is taken of all currently open Listers. If the script then opens or closes Listers itself, these changes will not be reflected by this collection. To re-synchronize the collection, call the **Update** method.                                                                                                                                                                                                                                                                                                                       |