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

# OnGetNewName

**OnGetNewName** 事件是[重命名脚本](/directory-opus/guan-fang-shou-ce/readme.zh-8/readme.zh.md)的三种可选入口点之一。另外两个事件 - **Rename\_GetNewName** 和 **Rename\_GetNewName2** 已经过时，只应用于与 Opus 10 的向后兼容。

| **方法名称:** | OnGetNewName                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **参数类型:** | [**GetNewNameData**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/getnewnamedata.zh.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **返回类型:** | *bool* 或 *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **描述:**   | <p>使用重命名脚本时，<strong>OnGetNewName</strong> 事件会针对每个选定的文件和文件夹调用，让脚本有机会修改名称。<br><strong>GetNewNameData.item</strong> 属性标识正在重命名的项目。您可以使用各种 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/item.zh.md"><strong>Item</strong></a> 属性访问项目的元数据和其它信息。<br><strong>oldname</strong> 属性返回用户在<a href="/directory-opus/guan-fang-shou-ce/readme.zh-2/readme.zh-1/readme.zh.md">重命名对话框</a>中输入的“旧名称”模式。<strong>newname</strong> 属性返回项目的建议新名称。它代表重命名对话框中所有其它非脚本选项（大写、自动编号等）的结果。</p><p>您可以从该事件返回两种不同类型：</p><ul><li><em>bool</em>: 如果您返回 <strong>True</strong>，则不会重命名项目。如果您返回 <strong>False</strong>（这是默认值），则将项目重命名为建议的新名称（<strong>newname</strong> 属性）。</li><li><em>string</em>: 您可以返回一个 <em>string</em> 来指定项目的新的名称。</li></ul> |
