# FlatViewChangeData

If a [script add-in](https://chaoses-ib.gitbook.io/directory-opus/manual/scripting/script_add-ins)implements the \*\*[OnFlatViewChange](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_events/onflatviewchange)\*\*event, the method receives a **FlatViewChangeData** object when the [Flat View](https://chaoses-ib.gitbook.io/directory-opus/manual/basic_concepts/flat_view) mode is changed in a tab.

| Property Name | Return Type                                                                                                                 | Description                                                                                                                                                                                                                                                                                                          |
| ------------- | --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| mode          | *string*                                                                                                                    | Returns a *string* indicating the new Flat View mode. Will be one of *off*, *grouped*, *mixed* or *mixednofolders*.                                                                                                                                                                                                  |
| qualifiers    | *string*                                                                                                                    | <p>Returns a string indicating any qualifier keys that were held down by the user when the event was triggered.<br>The string can contain any or all of the following: <em>shift</em> <em>ctrl</em>, <em>alt</em>, <em>lwin</em>, <em>rwin</em><br>If no qualifiers were down, the string will be: <em>none</em></p> |
| tab           | *object:*[**Tab**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/tab) | Returns a [**Tab**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/tab) object representing the tab the Flat View mode changed in.                                                                                                                              |
