DOpus
DOpus 对象是由 Opus 提供的两个全局脚本对象之一,所有 脚本均能使用。它提供了各种助手方法和集合,让你可以访问列表程序和工具栏等内容。
属性名称 | 返回类型 | 说明 |
---|---|---|
aliases | object:Aliases | |
favoriteformats | collection:Format | 返回一个 Format 对象集合,该集合表示已使用定义的收藏夹格式。 |
favorites | object:Favorites | 返回一个 Favorites 对象,它允许你查询和修改用户定义的收藏夹文件夹。 |
filetypegroups | object:FiletypeGroups | 返回一个 FiletypeGroups 对象,它让你可以列举和查询已配置的 文件类型组。 |
filters | object:GlobalFilters | 返回一个 GlobalFilters 对象,它允许你访问关于全局过滤器设置的信息(在配置中的 过滤器 页面上配置)。 |
language | string | 返回一个表示当前用户界面语言的字符串。 |
listers | object:文件窗口s | |
smartfavorites | object:智能收藏夹 | |
spacingscheme | string | 返回当前 UI 间距方案 的名称(如果有的话)。 |
strings | object:ScriptStrings | 返回一个 ScriptStrings 对象,它允许脚本访问任何定义为 字符串资源 的字符串。 |
tabgroups | object:TabGroups | |
vars | object:Vars | 这个 Vars 对象表示所有已定义的 全局作用域 变量。 |
version | object:Version | Version 对象提供有关当前 Opus 程序版本的信息。 |
viewers | object:Viewers |
方法名称 | Arguments | 返回类型 | 说明 | |||||||||||||||||||||||||||||||||
ClearOutput | none | none | 清除脚本输出日志。 | |||||||||||||||||||||||||||||||||
Create | none | object:DOpusFactory | 创建并返回一个新的 DOpusFactory 对象,它可用于创建各种轻量级助手对象,如 Blob、Map 和 Vector。 | |||||||||||||||||||||||||||||||||
Delay | <int:time> | none | 延迟指定毫秒数后再返回。 | |||||||||||||||||||||||||||||||||
Dlg | none | object:Dialog | 创建一个新的 Dialog 对象,让你可以显示对话框和弹出菜单。 注意: 脚本通常不应在响应由工具栏或文件夹标签页触发的事件时使用此方法。DOpus.Dlg 返回的 Dialog 不会配置其父窗口。大多数脚本事件会为你提供一个对象,该对象既可以创建预配置的 Dialog,也可以包括 SourceTab 属性或类似属性(做同样的事情)。在几乎所有情况下,你都应该使用它们。 | |||||||||||||||||||||||||||||||||
DPI | none | object:DPI | 创建 DPI 助手对象,它在处理不同的系统缩放设置(如高 DPI 监视器)时提供帮助。 | |||||||||||||||||||||||||||||||||
FSUtil | none | object:FSUtil | 创建一个新的 FSUtil 对象,它提供用于访问文件系统的助手方法。 | |||||||||||||||||||||||||||||||||
GetClip | none 或 <string:type> | string 或 object:Items | 检索系统剪贴板的当前内容(如果它包含文本或文件)。 你可以通过传递 "text" 或 "files" 来控制返回的类型,具体取决于 <type> 参数 - 如果可能,Opus 将转换为请求的类型。 如果未指定 <type>,内容将以其本机格式返回。 | |||||||||||||||||||||||||||||||||
GetClipFormat | none 或 <string:flags> | string | 返回一个字符串,指示剪贴板内容的本机格式。 可选标志:
可能返回值:
none or <string:flags> | object:文件窗口s | string | 返回一个表示当前按下的限定键的字符串。如无按下的限定键,字符串为“无”。否则,字符串可包含下列任意或全部内容,内容以逗号分隔:“shift”、“ctrl”、“alt”、“lwin”、“rwin”。 请注意,许多事件会传递给您类似的限定键列表。如果您传递的是限定键列表,则通常应使用该列表而不是调用 DOpus.GetQualifiers。 例如,传递给脚本命令一个包含 *限定 *属性的 Func 对象。该属性会告诉您在触发命令时按下了哪些键,这可能与几秒钟后按下的键不同。当用户单击按钮运行命令时,他们通常希望命令使用他们单击时按下的键,而不是在等待命令完成时稍后按下的键。 类似地,OnBeforeFolderChange 等事件通常会向您传递一个包含 限定 属性的对象(例如 BeforeFolderChangeData),当触发事件时,该属性指示键的状态。通常,您应该使用该属性,而不是调用 DOpus.GetQualifiers。 如果您确实调用了 DOpus.GetQualifiers,通常希望尽快调用它,然后存储结果,这样,用户在触发脚本后松开某个键的时间就会缩短。 如果您多次调用 DOpus.GetQualifiers,由于在调用之间按下或松开了某个键,每次可能会得到不同的结果。如果需要进行多次检查且需要这些检查保持一致,请调用一次该命令并存储结果。这通常不会影响前面提到的 qualifiers 属性,因为它们通常存储键状态的快照。 | ||||||||||||||||||||||||||||||
c | 区分剪切和复制的文件 | |||||||||||||||||||||||||||||||||||
files | 文件,如果 flags 省略或不包含 c | |||||||||||||||||||||||||||||||||||
files_copy | 通过复制(Ctrl-C)获取的文件,如果 flags 包含 c | |||||||||||||||||||||||||||||||||||
files_cut | 通过剪切(Ctrl-X)获取的文件,如果 flags 包含 c | |||||||||||||||||||||||||||||||||||
image | 位图数据 | |||||||||||||||||||||||||||||||||||
text | 文本数据 | |||||||||||||||||||||||||||||||||||
<empty string> | 空剪贴板,或任何其它类型的数据 | |||||||||||||||||||||||||||||||||||
Get文件窗口s | ||||||||||||||||||||||||||||||||||||
c | 当前桌面。仅返回当前桌面中的文件窗口。 | |||||||||||||||||||||||||||||||||||
GetQualifiers | ||||||||||||||||||||||||||||||||||||
LoadImage | <string:filename> 或 <object:Blob> [<int:width>] [<int:height>] [<bool:alpha>] | object:Image | 从指定的文件加载图像文件。可以选择指定要加载图像的所需大小,以及是否加载 Alpha 通道(如果有的话)。 可以使用 “#iconname” 从内部图标集中加载图标。例如, 可以通过附加图标索引到文件名,从 DLL 和 EXE 中提取图像,例如 您还可以提供包含图像数据而不是文件名的 Blob 对象。 返回的 Image 对象可以作为脚本对话框(当该控件处于“图像”模式时)中静态控件的 Control.label 属性的值(请参见 /Manual/scripting/script_dialogs/README.zh.md)。您还可以将其指定为 Dialog 对象的 icon 属性,以便为脚本对话框指定自定义窗口图标。 | |||||||||||||||||||||||||||||||||
LoadThumbnail | <string:filename> [<int:timeout>] [<int:width>] [<int:height>] [<string:flags>] | object:Image 或 bool (False) | 从指定的外部文件中提取缩略图。可以选择指定超时(以毫秒为单位)和要加载缩略图的所需大小。 可选的 flags 值支持以下标志(作为字符串提供):
如果加载失败(或在可以生成缩略图之前超时),此方法会返回 False。 返回的 Image 对象可以作为脚本对话框(当该控件处于“图像”模式时)中静态控件的 Control.label 属性的值(请参见 /Manual/scripting/script_dialogs/README.zh.md)。您还可以将其指定为 Dialog 对象的 icon 属性,以便为脚本对话框指定自定义窗口图标。 | |||||||||||||||||||||||||||||||||
i | 阻止 Opus 等待可能需要一段时间才能生成的缩略图,而是在无法立即生成缩略图时返回大图标 | |||||||||||||||||||||||||||||||||||
c | 将 i 标志修改为仅应用于云存储文件夹 | |||||||||||||||||||||||||||||||||||
MusicGenres | 无 | object:Vector | 返回一个由字符串组成的 Vector ,表示在元数据面板的流派字段中配置为显示的音乐流派。 | |||||||||||||||||||||||||||||||||
Notify | <string:title> <string:message> [<string:flags>] | 无 | 显示系统通知(或在 Windows 7 中显示气泡工具栏)。这要求将 Opus 任务栏图标添加到任务栏通知区域,因此,如果在配置中将其关闭,它会暂时添加,然后再次删除。 可选标志为:
<string:text> [<bool:error>] [<bool:timestamp>] | 无 | ||||||||||||||||||||||||||||||||
n | 无声音。阻止系统在显示通知时播放声音。 | |||||||||||||||||||||||||||||||||||
Output | ||||||||||||||||||||||||||||||||||||
ReloadScript | <string:file> | 无 | 导致 Opus 重新加载并重新初始化指定的脚本。您必须提供磁盘上的脚本完整路径(如果脚本加载项要重新加载自身,您可以传递 Script.file 属性的值)。 | |||||||||||||||||||||||||||||||||
SendKey | <string:key> | bool | 发送指定的击键到系统。该击键将发送到当前具有焦点的任何窗口。例如, 支持的限定键为 除了字母和数字,还支持以下命名键: | |||||||||||||||||||||||||||||||||
SetClip | <string:text> 或 object:Items 或 none | none | ||||||||||||||||||||||||||||||||||
Toolbars | <string:type> | object:**Toolbars ** | 返回一个 Toolbars 对象,该对象可以枚举所有已定义的工具栏(无论它们当前是否打开)。 你可以通过指定可选的 type 参数将此对象限制为仅返回正在使用的工具栏 - 指定 "listers" 以仅返回目前在文件窗口中打开的工具栏,指定 "docks" 以仅返回当前浮动的工具栏。 | |||||||||||||||||||||||||||||||||
TypeOf | any | string | 返回一个字符串,指示对象或变量的类型。 |
最后更新于