重命名脚本

这无疑是 高级重命名 对话框最强大的功能，但也是最复杂的功能。您可以编写重命名脚本，让您可以完全控制重命名操作的结果。

以下是脚本化重命名的一个相当简单的示例。您可以看到脚本编辑器已显示。这最初预先填充了一个不执行任何操作的脚本，您可以对其进行编辑。

顶部的 脚本类型 下拉框用于指定脚本语言 - 在上面的示例中，选择了 VBScript。

1. 对于要重命名的每个文件，Opus 都会调用 OnGetNewName 函数。

2. 传递给 OnGetNewName 函数的参数是 GetNewNameData 对象。

3. 从中我们获取 item 属性，它返回 Item 对象。

4. 从 Item 对象中，我们获取 metadata 属性，它返回一个 Metadata 对象。

5. 我们检查此对象的默认值 - 如果它返回“image”，我们知道该项目是一个图像文件。

6. 我们建立一个新名称，该名称由原始文件的名词干组成（Item.name_stem 属性，由 VBScript LCase 函数转换为小写）。

7. 然后我们附加一个显示图像尺寸的字符串（从提供 picwidth 和 picheight 属性的 Meta.image 对象中提取）。

8. 最后附加原始文件名扩展名（Item.ext）。

9. 新名称从 OnGetNewName 函数返回（上面所示的 VBScript 惯例是通过将其分配给函数本身的名称来返回值）。

10. 如果图像不是图像文件，我们将返回 True，这将告诉 Opus 跳过该文件而不将其重命名。

所有错误消息或脚本输出的其它文本都可以在 其它日志 日志窗口中查看，可以通过 工具面板（或 帮助 菜单中的 日志 / 其它日志 命令）进行访问。如果您发现脚本的行为与预期不符，则应检查此日志以查看是否生成了任何错误消息。您还可以使用 DOpus.Output 脚本方法将自己的文本输出到此日志，这有助于调试。

默认配置提供了 Number Files 脚本作为默认重命名预设之一，它是使用 VBScript 实现的，因此请随时查看它以获得更多复杂的示例。最后，请参阅 Opus 资源中心 上的 重命名脚本部分，以了解您可以下载和使用的重命名脚本示例，并且可以在论坛上寻求帮助撰写重命名脚本。

出于传统原因（因此，为早期版本的 Opus 编写的脚本仍将起作用），Opus 还支持两个替代函数。我们建议所有新脚本都使用上面所示的 OnGetNewName 事件。

最初支持的函数是 Rename_GetNewName，它采用多个参数，提供有关要重命名的文件的基本信息：

Function Rename_GetNewName ( strFileName, strFilePath, 
 fIsFolder, strOldName, ByRef strNewName 
 )
Rename_strNewName = 
 LCase(strNewName)
End Function

新名称在“按引用传递”变量 strNewName 中返回。第二个替代函数 Rename_GetNewName2 是为不支持“按引用传递”变量的脚本语言提供的。唯一的区别是 strNewName 不是按引用传递的，并且您使用函数的返回值指定新名称。使用 Rename_GetNewName2 的以上示例看起来会像这样：

Function Rename_GetNewName2 ( strFileName, strFilePath, 
 fIsFolder, strOldName, strNewName 
 )
Rename_GetNewName2 = 
 LCase(strNewName)
End Function

了解更多：

重命名对话框中的自定义字段