> 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-1/onscriptcolumn.zh.md).

# OnScriptColumn

**OnScriptColumn** 事件是 [自定义列](/directory-opus/guan-fang-shou-ce/readme.zh-8/readme.zh-6/adding_a_new_column.zh.md) 的入口点，该自定义列由 [脚本加载项](/directory-opus/guan-fang-shou-ce/readme.zh-8/readme.zh-1.md) 添加。该事件的实际名称由脚本本身在使用 [**ScriptInitData**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/scriptinitdata.zh.md)**.AddColumn** 方法添加命令时定义 - **OnScriptColumn** 只是一个占位符名称。

| **方法名称：**  | OnScriptColumn                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **参数类型：**  | [**ScriptColumnData**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/scriptcolumndata.zh.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **返回值类型：** | *无*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **描述：**    | <p>当脚本加载项使用 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/scriptinitdata.zh.md"><strong>ScriptInitData</strong></a><strong>.AddCommand</strong> 添加新列时，它会使用 <strong>ScriptColumn.method</strong> 属性指定其入口点的名称。当 Opus 需要检索特定文件或文件夹的列值时，Opus 将在你的脚本中调用该方法。 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/scriptcolumndata.zh.md"><strong>ScriptColumnData</strong></a><strong>.item</strong> 属性提供了有关所述文件或文件夹的信息，而 <strong>col</strong> 属性标识你应该返回数据的列（如果你使用一个方法来处理多个列）。</p><p>该事件的返回值将被忽略 - 相反，你应该通过设置 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/scriptcolumndata.zh.md"><strong>ScriptColumnData</strong></a> 对象中的相应值来返回列数据（以及可选的排序和分组信息）。</p> |
