> For the complete documentation index, see [llms.txt](https://chaoses-ib.gitbook.io/directory-opus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/flatviewchangedata.md).

# FlatViewChangeData

If a [script add-in](/directory-opus/manual/scripting/script_add-ins.md)implements the \*\*[OnFlatViewChange](/directory-opus/manual/reference/scripting_reference/scripting_events/onflatviewchange.md)\*\*event, the method receives a **FlatViewChangeData** object when the [Flat View](/directory-opus/manual/basic_concepts/flat_view.md) 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**](/directory-opus/manual/reference/scripting_reference/scripting_objects/tab.md) | Returns a [**Tab**](/directory-opus/manual/reference/scripting_reference/scripting_objects/tab.md) object representing the tab the Flat View mode changed in.                                                                                                                                                        |