# TabGroupTabList

The **TabGroupTabList** object represents a list of folders that will open as [file display tabs](../../../basic_concepts/the_lister/tabs) when the parent [tab group](../../../basic_concepts/the_lister/tabs/tab_groups) is opened. You can obtain this object from the **tabs**, **lefttabs** and **righttabs** properties of the [**TabGroup**](tabgroup) object.

The **TabGroupsTabList** object is a collection of [**TabGroupTabEntry**](tabgrouptabentry) objects; you can enumerate it to discover each folder tab.

| Property Name | Return Type                                     | Description                                                                                                              |
| ------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| active        | object:[**TabGroupTabEntry**](tabgrouptabentry) | Returns a [**TabGroupTabEntry**](tabgrouptabentry) object representing the active (default) folder tab in this tab list. |

| Method Name | **Arguments**                                                                                                                                                                                  | Return Type                                     | Description                                                                                                                                                                                                                                                                             |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddTab      | <p><em>&#x3C;object:</em><a href="tabgrouptabentry"><strong>TabGroupTabEntry</strong></a><em>></em><br><br>or</p><p>&#x3C;string:path><br>&#x3C;string:name></p>                               | object:[**TabGroupTabEntry**](tabgrouptabentry) | <p>Adds a folder tab entry to this list. You can provide a<br>**<a href="tabgrouptabentry">TabGroupTabEntry</a>**object, or the <em>path</em> and optional <em>name</em> of the new folder tab.</p>                                                                                     |
| DeleteTab   | <p><em>&#x3C;object:</em><a href="tabgrouptabentry"><strong>TabGroupTabEntry</strong></a><em>></em></p><p>or</p><p>&#x3C;int:index></p>                                                        | _none_                                          | <p>Deletes a folder tab entry from this list. You can provide a<br>**<a href="tabgrouptabentry">TabGroupTabEntry</a>**object, or the index of the tab entry to delete. If you specify the index as <strong>-1</strong> then all tab entries will be deleted.</p>                        |
| InsertTabAt | <p><em>&#x3C;object:</em><a href="tabgrouptabentry"><strong>TabGroupTabEntry</strong></a><em>></em><br><em>\</em> or</p><p>&#x3C;string:path><br>&#x3C;string:name></p><p>&#x3C;int:index></p> | object:[**TabGroupTabEntry**](tabgrouptabentry) | <p>Inserts a folder tab entry to this list. You can provide a<br>**<a href="tabgrouptabentry">TabGroupTabEntry</a>**object, or the <em>path</em> and optional <em>name</em> of the new folder tab. The final parameter must be the index indicating the desired insertion position.</p> |
| MoveTabTo   | <p><em>&#x3C;object:</em><a href="tabgrouptabentry"><strong>TabGroupTabEntry</strong></a><em>></em><br><em>&#x3C;object:<strong>TabGroupTabList</strong>></em><br>&#x3C;int:index></p>         | _none_                                          | Moves the specified tab entry to a new position, and optionally a new tab list. If the second parameter is a **TabGroupTabList** object then the tab entry will be moved to that list. The final parameter must be the index indicating the desired insertion position.                 |
