为动作设计自定义右键菜单

2024-07-12 05:32| 来源: 网络整理| 查看: 265

注：Quicker1.8.3以后的版本支持此功能。

概述

当动作功能变得更强大之后，通常会面临2个设计问题：

如何进入配置界面，让使用者方便的自定义一些个性化信息？动作提供多个功能或模式，如何在启动动作时确定运行哪个功能？

在1.8.3版本之前，动作作者大概会使用这些办法：

在动作操作界面的菜单中增加功能选项。（如文本窗口的菜单、用户选择的选项或菜单等）在启动时检查键盘状态，根据是否按下了某个控制键（如ctrl），决定进入参数配置功能还是正常运行动作。

在1.8.3版本中，Quicker增加了给动作自定义右键菜单的功能。基本原理是这样：

点击菜单时，运行动作并给动作传递某个特定的参数。在动作中判断参数变量quicker_in_param的值，根据对应的菜单项执行某个操作。

定义菜单

菜单数据在动作编辑窗口的“选项”区域。

输入框比较小，如果需要输入较多内容，可以在输入框上右键，选择“在编辑器中修改”。

格式说明每行定义一个菜单项；4个斜线开始的内容（////），作为注释忽略；使用4个半角短横线（----）添加分割线；每个菜单项的内容分为2个主要部分，中间使用竖线“|”分隔。前半部分定义菜单的外观；后半部分定义要给动作传递的参数；例子：[fa:Light_Flag]菜单标题(tooltip内容)|_qk_menu_icon_menu外观部分可以包含图标、标题和鼠标悬浮在菜单上时显示的Tooltip信息。其中图标信息和tooltip信息是可选的。图标信息：[fa:图标名称] 图标将以默认颜色显示（为和quicker内置右键菜单区别，动作图标默认使用绿色显示）。如果需要对某些具有一定风险或需要突出显示的图标指定自定义颜色，也可以使用 [fa:图标名:#RRGGBB] 这样的格式。图标名称可以在编辑器中右键选择“插入图标名菜单”后选择。

动作参数尽量使用较为特殊的内容，避免和正常使用动作时传入的参数冲突。如果有多个菜单项，也可以考虑为参数加入相同的前缀，从而方便在动作中根据前缀执行某个分支的步骤。

多级菜单

缩进方式设置（自1.36.7版本支持）

使用空格或tab缩进表示子菜单（空格或tab不能混用，同一级别对齐）。

示例：

[fa:Light_Cog:#FF0000]设置 [fa:Light_Cog:#FF0000]设置项1|参数值1 [fa:Light_Cog:#FF0000]设置项11|参数值11 [fa:Light_Cog:#FF0000]设置项2|参数值2 [fa:Light_Cog:#FF0000]设置项21|参数值21

对应的菜单：

符号标记格式

【1.36.7之前版本】如果需要定义二级菜单：

在父菜单的最前面加入 [+]在该父菜单下面的子菜单项的最前面加入 [-]

例子（网址https://getquicker.net/sharedaction?code=85e2fa76-4bfb-4e1b-aa78-08d80d33b91a）：

////注释内容无图标菜单|_qk_menu_no_icon 带Tooltip的菜单(tooltip内容)|_qk_menu_tooltip [fa:Light_Flag]带图标的菜单(tooltip内容)|_qk_menu_icon_menu [+][fa:Light_Cog]二级菜单(提示内容...) [-][fa:Light_UserCircle]子菜单|_qk_menu_submenu [fa:Light_Wrench:#f57e42]危险动作菜单(tooltip内容)|_qk_menu_sample

对应的菜单：