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

# Script

**Script** 对象是 Opus 提供的两个全局脚本对象之一。当 [脚本加载项](/directory-opus/guan-fang-shou-ce/readme.zh-8/readme.zh-1.md) 的各种事件处理程序被调用时（除了 [**OnInit**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh-1/oninit.zh.md) 事件），会提供此 \*\* \*\* 对象。它提供与脚本本身相关的信息。

| 属性名称   | 返回类型                                                                                                                 | 描述                                                                                                                                                                                                                                                                                                 |
| ------ | -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| config | *object:*[**ScriptConfig**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/scriptconfig.zh.md) | 返回一个 [**ScriptConfig**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/scriptconfig.zh.md) 对象，表示此脚本的配置值。在 [**OnInit**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh-1/oninit.zh.md) 方法中，脚本可以定义构成其配置的属性 - 然后用户可以在配置中编辑这些值。**config** 属性返回的对象表示用户选择的值。 |
| file   | *string*                                                                                                             | 返回此脚本的路径和文件名。                                                                                                                                                                                                                                                                                      |
| vars   | *object:*[**Vars**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/vars.zh.md)                 | 返回一个 [**Vars**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/vars.zh.md) 对象，表示作用于此特定脚本的变量。这允许脚本使用在脚本的一次调用到另一次调用之间持续存在的变量。                                                                                                                                                  |

| 方法名称            | **参数**                                                                           | 返回类型                                                                                                 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| InitColumns     | *none*                                                                           | *none*                                                                                               | 如果您的脚本实现了 [**OnAddColumns**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh-1/onaddcolumns.zh.md) 事件，您可以在任何时候调用 **InitColumns** 方法来重新初始化您的列。例如，您可能希望在响应用户修改脚本配置时执行此操作。                                                                                                                                                                                                                                                                                                                                                                              |
| InitCommands    | *none*                                                                           | *none*                                                                                               | 如果您的脚本实现了 [**OnAddCommands**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh-1/onaddcommands.zh.md) 事件，您可以在任何时候调用 **InitCommands** 方法来重新初始化您的命令。例如，您可能希望在响应用户修改脚本配置时执行此操作。                                                                                                                                                                                                                                                                                                                                                                          |
| LoadImage       | <p>\<string:name><br>\[\<int:width>]<br>\[\<int:height>]<br>\[\<bool:alpha>]</p> | object:[**Image**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/image.zh.md) | <p>从指定的外部文件加载图像文件。如果您的脚本被捆绑为 <a href="/pages/Jd8kmG29xlsP8aLVmY74">脚本包</a>，您可以将图像文件放置在名为 <strong>images</strong> 的包的子目录中，然后通过给出其名称从脚本中加载它们。您可以选择指定要加载图像的所需大小，以及是否应该加载 alpha 通道（如果有）。</p><p>返回的 <a href="/pages/Vd1dj4rpfjwe9YiRMXUJ"><strong>Image</strong></a> 对象可以作为 <a href="/pages/bJzM9M5SIt5GD8jIPQea">脚本对话框</a> 中静态控件的 <a href="/pages/WRJAzx52tNbRc2sSSCyk"><strong>Control</strong></a><strong>.label</strong> 属性的值（当该控件处于“图像”模式时）。您还可以将其分配到 <a href="/pages/jgwgSiuQnFDqq9Juxgmh"><strong>Dialog</strong></a> 对象的 <strong>icon</strong> 属性以指定脚本对话框的自定义窗口图标。</p> |
| LoadResources   | <p>\<string:name> 或<br>\<string:XML></p>                                         | *none*                                                                                               | 加载外部 [脚本资源](/directory-opus/guan-fang-shou-ce/readme.zh-8/readme.zh-5.md) 并使它们可供脚本使用。您可以提供文件名或原始 XML 字符串。如果您的脚本被捆绑为 [脚本包](/directory-opus/guan-fang-shou-ce/readme.zh-8/readme.zh-1/script_package.zh.md)，资源文件必须具有 **.odxml** 扩展名才能让 **LoadResources** 能够在包中找到它。                                                                                                                                                                                                                                                                                                          |
| RefreshColumn   | \<string:name>                                                                   | *none*                                                                                               | 如果您的脚本实现了任何自定义列，您可以使用此方法在当前显示在任何标签页中的情况下重新生成它们。例如，您可能希望在响应用户修改脚本配置时执行此操作。将要重新生成的列的名称作为参数传递给此方法。                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Update即时查找Flags | <p>\<string:name><br>\<int:flags></p>                                            | *none*                                                                                               | <p>让脚本加载项更新 <a href="/pages/UdHIV7WMeL9zZSdHlMnb">即时查找扩展</a> 的标志。这等同于向用户显示的 <a href="/pages/mjIgY36XwIAF8pmkz1Ak">快速键</a> 配置页面上的即时查找模式的选项。</p><p><em>name</em> 应为即时查找扩展命令的名称；这将作为 <a href="/pages/f5HVx2ukzKX92B0QwToR"><strong>ScriptFAYTCommandData</strong></a><strong>.fayt</strong> 属性传递给您的命令。<em>flags</em> 值应表示对您的扩展有意义的标志组合。</p>                                                                                                                                                                                                                                  |
