> 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/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/beforefolderchangedata.zh.md).

# BeforeFolderChangeData

如果一个[脚本加载项](/directory-opus/guan-fang-shou-ce/readme.zh-8/readme.zh-1.md)实现了\*\*[OnBeforeFolderChange](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh-1/onbeforefolderchange.zh.md)\*\* 事件，则该方法会在读取新文件夹之前收到一个**BeforeFolderChangeData** 对象。

| 属性名称       | 返回值类型                                                                                                | 描述                                                                                                                                                                             |
| ---------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| action     | *string*                                                                                             | 返回一个字符串，指示触发文件夹读取的操作。字符串将是以下之一：*normal*、*refresh*、*refreshsearch*、*refreshsub*、*parent*、*root*、*back*、*forward*、*dblclk*。 *refreshsub* 操作表示在平板视图打开时刷新文件夹（及其子文件夹）。其它操作名称应该不言自明。 |
| initial    | *bool*                                                                                               | 如果这是第一个要读取到此标签的路径（即之前标签为空），则返回**True**。                                                                                                                                        |
| path       | *object:*[**Path**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/path.zh.md) | 返回一个\*\*[Path](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/path.zh.md)\*\* 对象，表示要读取的新路径。                                                              |
| qualifiers | *string*                                                                                             | 返回一个字符串，指示用户在触发事件时按下的任何限定键。 字符串可以包含以下任何或所有内容：*shift* *ctrl*、*alt*、*lwin*、*rwin* 如果没有按下限定键，字符串将为：*none*                                                                         |
| tab        | *object:*[**Tab**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/tab.zh.md)   | 返回一个\*\*[Tab](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/tab.zh.md)\*\* 对象，表示正在更改文件夹的标签。                                                             |