命令修饰符参考
以下列出了工具栏按钮和热键中支持的各种 命令修饰符。
@if:!Set DUAL=on @if:Set DUAL=off @ifset:!DUAL=on @ifset:DUAL=off
修饰符 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
@admin | 该函数需要管理员权限。该修饰符将导致出现 UAC 提示(除非文件窗口已处于 管理员模式),并且该函数运行的任何外部程序都将提升。 如果单独使用,此修饰符将影响整个函数。它还可用于提升特定命令,而不是提升整个按钮。
此修饰符后面的命令将异步运行 - Opus 在运行函数中的下一个命令(或再次针对下一个所选文件运行此命令)之前,将不会等待此命令退出。 默认行为是对于包含单个命令的函数,该函数将异步地针对每个所选文件运行该命令;包含多个命令的函数将同步运行每个命令。默认行为可以通过配置中“杂项/高级 页面上的 function_default_async 选项更改,或者可以通过此修饰符在每个命令的基础上覆盖。
更改 MS-DOS 批处理命令 的代码页。如果未指定,默认代码页为 1252 (Windows-1252)。
显示确认对话框。如果用户单击“取消”按钮,则会在此处中止函数。 此修饰符的模板为:@confirm:<message>|<positive text>|<negative text> <message> 是对话框中显示的文本,<positive text> 是“确定”按钮上显示的文本,<negative text> 是“取消”按钮上显示的文本。这三个字符串都是可选的 - 如果未提供,将使用默认字符串。如果您提供了 <positive text> 但未提供 <negative text>,则该对话框将有一个“确定”按钮,但没有“取消”按钮。 您可以使用特殊代码 在消息文本中包含换行符(如果您需要在文本中包含一个字面量 序列,您必须转义 \ 字符,就像在 中一样)。
这使用求值器返回一个简单的字符串;从功能上讲,这与仅仅将 Go DRIVEBUTTONS 命令放在工具栏按钮上没有什么不同。 作为一个更复杂的示例,默认的 收藏栏 工具栏使用 @ctx 来构建显示的收藏夹列表,通过使用求值器使用收藏栏分支的当前本地化名称构建命令行: 这使用求值器 LanguageStr() 函数检索已知字符串的翻译名称,并使用 Favorites 命令构建一个命令行,以显示收藏夹树的该分支。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@admin | 提升整个函数 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@admin:notepad.exe {f} | 只提升记事本 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@admin:no | 禁用此函数中任何后续命令的 UAC 提示 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@admin:yes | 针对任何后续命令重新启用 UAC 提示 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@async | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@async:notepad.exe {f} | 异步运行记事本 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@codepage | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@codepage:1258 | 将代码页设置为越南语 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@confirm | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@confirm:Really copy files? | 针对确定和取消按钮使用默认文本 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@confirm:Really proceed?|Oui!|Non! | 针对两个按钮指定自定义文本 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@confirm:All finished|Acknowledged | 针对确定按钮的自定义文本;根本没有取消按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ctx | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@dirsonly | 该函数将仅针对所选文件夹进行操作,忽略任何文件。
如果命令子句测试为假,按钮将被禁用。这类似于下面描述的 @if 修饰符提供的条件测试。
@disableifpath @disableifpathr | 如果当前源路径与指定模式匹配,则按钮将被禁用。您可以提供绝对路径进行测试,或提供通配符模式(针对 标准通配符 使用 @disableifpath,针对 正则表达式 使用 @disableifpathr)。您还可以使用关键字 shell 来测试托管的 shell 命名空间扩展(虚拟文件夹)。
仅当使用通配符(而非正则表达式)时,路径才可以使用别名、环境变量、{apppath} 代码等:
当未选择任何文件或文件夹时,或当未选择任何特定类型的文件时(可选),将禁用该命令。对于某些标准命令,此操作将自动执行,并且此修饰符能让您以类似的方式执行您自己的命令。这与 @hidenosel 类似。
对于文件窗口工具栏,您可以使用 minfiles、maxfiles 和 numfiles 关键字分别指定启用按钮时必须选择的文件的最小数量、最大数量或确切数量。类似地,mindirs、maxdirs 和 numdirs 可以限制已选择文件夹的数量。
使用 type 关键字,您可以配置一个按钮,除非至少选择了一个文件,否则禁用该按钮,且该文件名称与提供的通配符模式匹配。(不需要所有选中的文件都匹配模式;只需要一个。)您还可以将这个与 dirs 结合起来,如果选择了文件夹或选择了特定类型的文件,则该按钮将起作用。如果您使用 type,它必须是行上的最后一项,因为 = 号后面的所有内容都将被视为模式的一部分(允许模式包含原本会与其它关键字和参数混淆的项)。
您还可以使用 ! 字符来否定测试。它必须是 : 号后的第一个字符。例如:
如果命令子句测试为真,则将启用该按钮。这与下面描述的 @if 修饰符提供的条件测试类似。
@enableifpath @enableifpathr | 如果当前源路径与指定的模式匹配,则将启用该按钮。您可以提供一个绝对路径来进行测试,或者一个通配符模式(对于 标准通配符,使用 @enableifpath,对于 正则表达式,使用 @enableifpathr)。您还可以使用关键字 shell 来测试托管的 shell 名称空间扩展(虚拟文件夹)。
只有在使用通配符(不是正则表达式)时,路径才可以使用别名、环境变量、{apppath} 代码等:
@eval @evalalways | 暂时不做 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@dirsonly | 仅针对目录进行操作 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disableif | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disableif:Set DUAL=toggle | 如果文件窗口处于双屏模式中,则按钮将被禁用 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disableif:!Set DUAL=toggle | 如果文件窗口不处于双屏模式中,则按钮将被禁用 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disableifpathr:^C:\ | 如果源路径位于 C: 驱动器上,则禁用命令 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disableifpath:!*\Work\* | 除非源路径位于名为 Work 的文件夹下,否则禁用* | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disableifpath:!/desktop | disable unless in the Desktop folder | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disableifpath:!%SystemRoot%\System32 | disable unless in C:\Windows\System32 (on a typical system) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disableifpath:{apppath|dopus.exe} | disable if in the folder where Opus is installed | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disableifpath:shell | disable if in a hosted virtual folder | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel | disable button when nothing is selected | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel:files | disable button when no files are selected | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel:dirs | disable button when no folders are selected | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel:numfiles=2 | disable button unless exactly 2 files are selected | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel:maxfiles=5 | disable button unless 5 files or fewer are selected | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel:mindirs=3,maxdirs=5 | disable button unless 3, 4 or 5 folders are selected | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel:type=*.jpg | disable button when no files ending with ".jpg" are selected | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel:type=old | disable button when no files beginning with "old" are selected | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel:dirs,type=*.png | disable unless any folders, or any files ending with ".png", are selected | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@disablenosel:!type=*.jpg | disable button if files ending with ".jpg" are selected | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@enableif | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@enableif:Set DUAL=toggle | button will be enabled if the文件窗口is in dual-display mode | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@enableif:!Set DUAL=toggle | button will be enabled if the文件窗口is NOT in dual-display mode | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@enableifpathr:^C:\ | enable command if source path is on the C: drive | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@enableifpath:!*\Work\* | enable unless source path is underneath a folder called Work | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@enableifpath:!/desktop | enable unless in the Desktop folder | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@enableifpath:!%SystemRoot%\System32 | enable unless in C:\Windows\System32 (on a typical system) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@enableifpath:{apppath|dopus.exe} | enable if in the folder where Opus is installed | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@enableifpath:shell | enable if in a hosted virtual folder | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@externalonly | 忽略函数中指定的任何 Opus 内部命令,并将所有命令视为外部命令。这允许您配置一个 MS-DOS 批处理函数,使用诸如 copy 之类的命令,这些命令通常会被内部命令集覆盖。
仅通过拖放接受文件和文件夹。具有此修饰符的按钮将忽略文件窗口中的任何所选文件或文件夹 - 只有通过拖放到按钮上的文件才会被该按钮中的命令使用。
该函数将仅对选定的文件进行操作,忽略任何文件夹。
此指令只在嵌入式功能里使用。它允许你指定嵌入式功能的类型(如果未指定,嵌入式功能被假定为标准功能——Opus 或外部命令)。例如,下面的命令会用一个嵌入式脚本函数打开一个新的文件浏览窗口,该函数在新的文件浏览窗口的上下文中运行:
@hideblock 修饰符允许你使用各种其它修饰符来一次隐藏或显示多个按钮,而不必在每一个按钮中重复测试。 在按钮中用 @hideblock:begin 结合其它适当的修饰符来开始块。块内的按钮将根据第一个按钮的状态来显示或隐藏。例如, 此按钮基于当前视图模式开始一个隐藏/显示块。如果当前视图为缩略图模式,按钮将显示——否则将隐藏它们。 在另一个按钮中用 @hideblock:end 结束此块。开始和结束之间的所有按钮将被作为整体来隐藏或显示。注意:开始和结束按钮永远不显示在自定义模式之外。
如果一个命令语句测试结果为假,按钮将被隐藏。这类似于下面描述的 @if 修饰符提供的条件测试。
@hideifpath @hideifpathr | 如果当前源路径与指定模式不匹配,按钮将被隐藏。你可以提供一个用来测试的绝对路径或一个通配符模式(对标准通配符使用 @hideifpath,对正则表达式使用 @hideifpathr)。
路径仅在使用通配符(不是正则表达式)时才可能使用别名、环境变量和 {apppath} 代码,如下所示:
当没有文件或文件夹被选中时,或者可选地,当没有任何特定类型的文件被选中时,按钮将被隐藏。这类似于 @disablenosel。
对于文件浏览窗口工具栏,你可以使用 minfiles、maxfiles 和 numfiles 关键字来指定被选中的文件数量的最小值、最大值或确切值,以使按钮可见。类似地,mindirs、maxdirs 和 numdirs 可以限制被选中的文件夹数量。
使用 type 关键字,你可以配置一个按钮,在找不到与提供的通配符模式相匹配的文件时才隐藏。(所有选定的文件都不需要与模式匹配;只要有一个就行。)你还可以将此与 dirs 结合起来,为以下情况下可视的按钮创建它:某个文件夹被选中,或者某种类型的文件被选中。如果你使用 type,它必须是该行上的最后一个,因为 = 之后的所有内容都将被认为是模式的一部分(允许模式包含原本会被与其它关键字和参数混淆的内容)。
你也可以使用 ! 字符来否定测试。它必须是 : 之后的第一个内容。例如,
@icon 指令可让你创建按钮,而这些按钮会基于命令句(通常通过 Set 指令,类似于 @if 和 @ifset)的测试结果,动态地更改其图标。默认的 视图模式循环 按钮使用该指令将图标更改为反映当前的视图模式。 此按钮上的每个 @icon 指令均会指定要使用的图标和要测试的命令指令。例如,如果 Set VIEW=LargeIcons 测试为真,则按钮上将显示名为 largeicons 的图标。如果其它 @icon 测试均不匹配,则使用按钮本身设置的图标作为默认图像。 对于三按钮按钮的特殊情况,@iconp: 和 @icon!: 指令也可用于任一子按钮上以更改父按钮的图标。在任一子按钮上使用的 @iconp: 将设置父按钮的图标(但不会对子按钮做任何操作)。在任一子按钮上使用的 icon!: 将设置父按钮的图标以及该子按钮的图标。 如果你基于 Set 命令进行测试,则技术上来说命令名称是可选的,并且可以省略。例如,单独的 VIEW=LargeIcons 与 Set VIEW=LargeIcons 相同。提供此能力是为了避免损坏旧按钮;对于新按钮,我们建议你在所有情况下都包含命令名称以避免将来出现问题。 在命令编辑器中,你可以 Ctrl+单击 @icon: 字符串以直接选择图标。 @icon 可使用 RECYCLEBINEMPTY 参数来测试回收站是否为空。例如: 在回收站状态更改时,使用 RECYCLEBINEMPTY 和 @icon 的工具栏按钮将自动刷新自身(这让你可以拥有一个图标反映回收站状态的按钮)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@externalonly | external commands only | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@filesfromdroponly | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@filesfromdroponly | accept files only via drag-and-drop | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@filesonly | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@filesonly | operate only on files | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@firstfileonly | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
此功能只对第一个选中的文件进行操作,而不管有多少项被选中或拖拽到按钮上。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@firstfileonly | 只操作第一个选中的文件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@functype | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@functype:script | 嵌入式函数是脚本 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@functype:msdos | 嵌入式函数是 MS-DOS 批处理函数 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideblock | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideblock:begin | 开始一个隐藏块 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideblock:end | 结束一个隐藏块 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideif | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideif:Set DUAL=toggle | 如果文件浏览窗口在双重显示模式中,按钮将被隐藏 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideif:!Set DUAL=toggle | 如果文件浏览窗口不在双重显示模式中,按钮将被隐藏 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideifpathr:^C:\ | 如果源路径在 C: 驱动器上,则隐藏命令 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideifpath:!*\Work\* | 除非源路径在名为 Work 的文件夹下,否则隐藏* | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideifpath:!/desktop | 除非在桌面文件夹中,否则隐藏 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideifpath:!%SystemRoot%\System32 | 除非在 C:\Windows\System32 中(在一个典型系统上),否则隐藏 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hideifpath:{apppath|dopus.exe} | 如果在 Opus 已安装的文件夹中,则隐藏 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel | 在没有任何东西被选中时隐藏按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel:files | 在没有文件被选中时隐藏按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel:dirs | 在没有文件夹被选中时隐藏按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel:numfiles=2 | 除非有恰好 2 个文件被选中,否则隐藏按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel:maxfiles=5 | 除非被选中的文件数量少于或等于 5,否则隐藏按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel:mindirs=3,maxdirs=5 | 除非被选中的文件夹数量为 3、4 或 5,否则隐藏按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel:type=*.jpg | 在没有以 ".jpg" 结尾的文件被选中时隐藏按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel:type=old | 在没有以 "old" 开头的文件被选中时隐藏按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel:dirs,type=*.png | 除非有任何文件夹或任何以 ".png" 结尾的文件被选中,否则隐藏 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@hidenosel:!type=*.jpg | 如果以 ".jpg" 结尾的文件被选中,则隐藏按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifexists | 基于指定的驱动器或路径是否存在来允许基本的条件行为。如果使用 wild: 前缀,则路径的最终组件可以包含标准通配符。
根据文件或文件夹选择,允许函数执行不同操作。可用的测试与 @disablenosel 修饰符(上面已记录)相同。 例如, | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifexists: | <驱动器或路径> - 测试驱动器或路径是否存在 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifexists:wild: | <驱动器或路径> - 测试驱动器或路径是否存在。允许在最终路径组件中使用通配符 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifexists:! | <驱动器或路径> - 测试驱动器或路径不存在 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifexists:else | 如果路径不存在,则执行的“else”子句 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifexists:common | 始终执行的公共指令 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifsel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifpath @ifpathr | 允许基于当前的源路径来执行基本条件行为。可以提供一个绝对路径以进行测试,或者提供一个通配符模式(对于*标准通配符使用 @ifpath*,对于*正则表达式使用 @ifpathr*)。 例如,可以在双击图像文件时(根据文件存储位置)使用此功能来打开不同的程序。如果以下命令被添加到图像文件类型组的左侧双击 事件,则双击网络上的图片时,它们将在 Opus 查看器 中打开,而双击本地驱动器上的文件时,它们将在 Photoshop 中打开。 此修饰符的可能形式为:
通过在前缀中添加 ! 字符,可以否定该条件。 示例:
允许基于当前正在运行的指定进程来执行基本条件行为。可以使用通配符,或(通过在 模式前加上 regex:)正则表达式。
允许基于函数运行时按住不同的限定键来执行基本条件行为。 要测试的限定键使用一个或多个关键字(shift、ctrl 和 alt)指定,这些关键字代表 Shift、Ctrl 和 Alt 键。例如,可以将某个按钮配置为选择所有文件,然后根据按住的键进行复制、移动或创建快捷方式。 此修饰符的可能形式为:
TOBEDONE 如果某物修改变量或其它影响动态标签的因素,它应通知 Opus,以便可以更新标签和工具栏布局。命令应使用 @toggle:update(见下文)并且脚本可以使用 Command.UpdateToggle 执行此操作。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifpath:<path or wildcard> | 使用标准模式匹配测试路径 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifpathr:<regular expression> | 使用正则表达式测试路径 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifpath:else | 如果没有任何匹配项,则执行的“else”子句 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifpath:common | 始终执行的公共指令 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifpath:C:\Program Files | 测试您位于 C:\Program Files 中 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifpath:!C:\Program Files | 测试您位于 C:\Program Files 以外的任何位置 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifpath:C:\Program Files\* | 测试您位于 C:\Program Files 下的某个文件夹中(不包括 Program Files 本身) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifpath:!C:\Program Files\* | 测试您位于 C:\Program Files 下的某个文件夹外 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifrunning | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifrunning:notepad.exe | 测试记事本是否正在运行 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifrunning:!note* | 测试以“note”开头的进程是否未在运行中 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifrunning:else | 如果进程不存在,则执行的“else”子句 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ifrunning:common | 始终执行的公共指令 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@keydown | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@keydown:<qualifiers> | 测试限定键或键组合 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@keydown:!<qualifiers> | 测试限定键或键组合未被按下 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@keydown:any | // 如果按住任何限定键*| |@keydown:none|如果没有按住限定键,则执行的指令| |@keydown:common|*始终执行的公共指令// | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@label | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@leavedoswindowopen | 为 MS-DOS 批处理函数 打开的控制台窗口在函数完成后仍然保持打开状态。如果没有此修饰符,窗口将在函数完成时关闭,这可能使读入任何命令行程序的输出变得困难。保持 DOS 窗口打开依赖于向系统命令解释器 cmd.exe 传递特定参数 (/K)。如果你通过设置 %ComSpec% 环境变量修改了系统上的默认命令处理器,Opus 不会传递 /K,因为它无法知道这个参数是否会被新命令处理器理解。与此相反,你可以设置 %ComSpecLeaveOpenArg% 环境变量,每当使用 @leavedoswindowopen 时,它将替代 %ComSpec%。
指示 Windows 记录此函数打开的程序或文档的使用情况。通常这意味着使用的任何文件都将添加到最近的文档列表,启动的任何程序都将添加到最近的应用程序列表。
调用外部 .bat 文件的 MS-DOS 批处理函数 将直接运行它,而不是使用 call 语义。这意味着在外部 .bat 文件完成后,控件将不会返回到父函数。默认行为是使用在结尾处将控件返回到父函数的 DOS call 指令。
文件和文件夹将在函数结束时仍然处于选中状态。在配置中的 文件操作/选项 页面上,这让你能按每个函数覆盖 取消选中在函数中使用文件 选项。
防止在函数中扩展任何环境变量。通常在函数解析阶段会扩展环境变量(比如 %USERPROFILE%) - 此修饰符导致变量名保持不变。
禁用 Opus 在使用 外部代码(比如 {filepath})传递包含空格的文件的名称时执行的自动引用。默认情况下,Opus 会用引号包裹嵌入空格的名称,但是有时你可能想要禁用此操作 - 某些外部程序可能不需要或不理解其命令行上的引号,你可能还想在函数中提供明确的引号,以防自动引用因复杂命令结构而导致混淆。
当 Opus 将其路径传递给外部程序时,防止 Opus 自动下载或提取非文件系统文件。例如,你可能想要使用 {filepath} 将远程 FTP 服务器上文件的 ftp:// 路径传递给外部程序。默认情况下,Opus 会将文件下载到临时文件中,并将临时文件的名称传递给程序 - 使用此修饰符后,Opus 将传递原始文件路径。
禁用此函数的自动进度指示符显示。你应谨慎使用此设置,因为如果没有进度指示符,就无法中止命令或监控其进度。通常,只有当脚本函数想要提供和控制其自己的进度指示符时才应使用此设置。
当 MS-DOS 批处理函数 组合内部和外部命令时,默认行为是 Opus 在每个内部命令处拆分函数并执行所有在前一个内部命令之前遇到的外部命令。例如,想象下面的(相当无意义的)函数: 此函数的默认行为是打开一个 DOS 窗口并打印字符串 "one",然后显示 Opus 关于 对话框,然后打开另一个 DOS 窗口并打印字符串 "two"。但是,如果将函数更改如下: 新行为是首先显示 关于 对话框,然后打开一个 DOS 窗口并打印字符串 "one" 和 "two"。@norunbatch 修饰符导致首先执行所有 Opus 内部命令,然后执行所有外部命令。
向系统发送指定的击键。该键将被路由到当前获得焦点的窗口。例如, 支持的限定符键有 除了字母和数字之外,还支持以下命名键: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@leavedoswindowopen | 函数执行完成后保持 DOS 提示符打开 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@logusage | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@logusage | 记录文件和应用程序的使用情况 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@nocall | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@nocall:<批处理文件> | 调用外部批处理文件,不要将控件返回此函数 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@nodeselect | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@nodeselect | 不要取消选中此函数使用的项目 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@noexpandenv | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@noexpandenv | 不要扩展环境变量 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@nofilenamequoting | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@nofilenamequoting | 不要自动引用文件名称和路径 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@nolocalizefiles | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@nolocalizefiles | 不要自动本地化(下载)远程文件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@noprogress | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@noprogress | 不要为此函数显示自动进度对话框 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@norunbatch | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@norunbatch | 不要因为内部命令而拆分批处理函数 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
此命令子句测试为 false 时,将会显示该按钮。这类似于 @if 修饰符提供的条件测试。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@showif:Set DUAL=toggle | 如果文件窗口处于双栏模式,将显示该按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@showif:!Set DUAL=toggle | 如果文件窗口不处于双栏模式,将显示该按钮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@sendkey | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@showifpath @showifpathr | 如果当前源路径与指定模式不匹配,将显示该按钮。您可以提供要测试的绝对路径或通配符模式(对于 标准通配符,请使用 @showifpath,对于 正则表达式,请使用 @showifpathr)。
路径可以使用别名、环境变量、{apppath} 代码等,但仅在使用通配符时(不包括正则表达式):
此修饰符之后所述的命令将同步运行 - Opus 将等待该命令退出后,再运行该函数中的下一个命令(或再次运行该命令以执行下一个选定的文件)。 对于仅包含一个命令的函数,其默认行为是异步为每个选定的文件运行该命令;包含多个命令的函数将同步运行每个命令。可以在配置中的 杂项 / 高级 页面上使用 function_default_async 选项更改默认行为,或者可以使用此修饰符按每个命令进行覆盖。
对于指示或更改状态的按钮(例如 Set VIEW=details),此修饰符可以让您更改按钮显示高亮时的状态。 根据按钮的显示位置,高亮可能显示为复选标记(例如在纯文本菜单中),或成为以不同颜色或样式绘制的图标或标签背景(类似于按下按钮时)。 以 Set VIEW=details 命令为例,通常在文件列表为“详细信息”模式时,按钮将显示为高亮,在其它任何模式下都不会高亮。@toggle 修饰符可以更改此行为:
@toggle 修饰符还可以通过测试某个命令来控制按钮何时显示为高亮,这类似于 @if 和 @ifset 测试命令以决定要运行什么**。** 您可以基于与按钮实际运行的命令不同或作为补充的命令来高亮按钮。 例如,此按钮不带有任何 @toggle 行,单击后将切换到 详细信息 模式,并且在您处于 详细信息 模式时也会显示为高亮: 未指定 @toggle 时,高亮(如果有)将基于按钮中的第一个命令。 使用 @toggle,您可以执行操作,例如在测试另一个操作的同时运行一个 Set 命令。作为一个简单、有些牵强的示例,以下按钮在单击时切换到 详细信息 模式,但在处于增强模式时显示为高亮: 您可以将 @toggle 在第一个命令后进行测试,而不是替代它,方法就是在"if"后面加上"&"字符: 如果没有 @toggle 行,则当视图模式为 详细信息(由于该命令)时,按钮将高亮,而高亮不会受到 Thumbnail 列的影响(高亮不考虑第二个命令)。添加 @toggle 行后,按钮仅在视图模式设置为 详细信息 且存在 Thumbnail 列时才会高亮。 您可以从 @toggle 行中省略 "Set" 命令名称;如果未指定名称,它将假定您是指 Set 命令。但是,此容差是为了避免破坏旧按钮,我们建议您在创建新按钮时始终指定该命令。 您可以通过分号将多个命令分隔开,从而一次测试多个命令。例如,您可以省略与号,并使用以下指令测试 详细信息 模式和 Thumbnail 列(无论按钮中是否存在任何其它命令,甚至作为按钮中的唯一行,此指令都将起作用): 您还可以在 Set 子句前加上感叹号来否定测试结果。例如,若要在除详细信息模式外的任何模式下让按钮出现选中状态: @toggle 指令还可以测试变量的存在(通过 @set 指令设置的变量)。要使其正常工作,指令必须是按钮的第一行,并且您要测试的变量必须具有标签页、文件窗口或全局范围。您可以使用此选项来创建您自己的自定义切换按钮,这些按钮使用范围变量跟踪其状态。例如: @切换:如果 $glob:TestVar @如果:$glob:TestVar @设置 glob:TestVar @否则:如果 @设置 glob:TestVar=on 此按钮测试是否存在一个名为 TestVar 的全局变量。如果该变量存在,则该按钮将显示高亮。单击该按钮会对 @ifset: 指令进行求值,并将反转该变量的状态:如果设置了该变量,那么它将被删除;否则,它将被设置。最终结果是一个按钮,它除了每次单击时切换变量及其可见状态外,没有其它功能。(如果该变量控制其它情况,例如其它命令或脚本的行为或 状态栏元素 的可见性,那么这会很有用。) 以这种方式以 @toggle:if 开头的按钮每当在其中使用 @set 时,都会自动更新其外观(以反映该变量状态的变化)。如果您在单独的按钮或热键中使用 @set 来更改变量,则需要使用特殊命令 @toggle:update 来强制更新切换按钮的外观。 例如,如果您有一个根据变量高亮的按钮,但不更改该变量: 如果您有另一个更改该变量但未根据该变量高亮的按钮,那么您需要添加 @toggle:update 行以确保在单击第二个按钮时更新第一个按钮的高亮: @toggle:update 命令还将强制所有状态栏刷新,以防它们正在 使用变量 来显示或隐藏信息。 您还可以使用 @toggle:update 来确保具有动态标签的按钮(通过上述**@label**)在更改标签所依赖的变量或其它详细信息后得到更新。如果标签宽度发生变化,这还将确保调整工具栏布局。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@showifpathr:^C:\ | 如果源路径在 C: 驱动器上,则显示命令 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@showifpath:!*\Work\* | 除非源路径位于名为 Work 的文件夹下方,否则显示* | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@showifpath:!/desktop | 除非位于桌面文件夹中,否则显示 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@showifpath:!%SystemRoot%\System32 | 除非位于 C:\Windows\System32(在典型系统中)中,否则显示 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@showifpath:{apppath|dopus.exe} | 如果位于 Opus 安装所在的文件夹中,则显示 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@sync | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@sync:notepad.exe {f} | 以同步方式运行记事本 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@toggle | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@toggle:invert | 反转工具栏按钮的通常高亮状态 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@toggle:disable | 阻止按钮在任何时候显示高亮 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@使用活动列表项 | 该函数将在活动列表项中操作,而不是当前源列表项中。通常它们会是同一样内容,但这对于您希望操作任何当前活动列表项窗口的热键很有用,而无需确保该列表项首先设置为源。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@useactivelister | 使用活动列表项而非源列表项 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
最后更新于