[]
        
(Showing Draft Content)

命令属性

在命令中包含另一个命令的情况并不常见,但是有些情况确实需要它。例如:

  1. 执行命令的命令时弹出通知栏,点击通知栏的时候需要跳转到表单页面。

  2. 执行命令的时候需要弹出确认对话框,等点击确认或取消时又要分别执行不同的命令。

以上情况就可能用到命令属性。当然,有时也会用定义子命令功能实现相同的效果,两种方式在功能和体验上略有差别,在本章节的最后会有专门的比较。

如果希望通过命令对话框编辑,可以通过标注CustomCommandObjectAttribute 的方式设置。

注意,标注CustomCommandObjectAttribute的属性类型必须是 object。

    public class MyPluginCommand : Command
    {
        [CustomCommandObject]
        [DisplayName("点击通知命令")]
        public object ClickNoticeCommand { get; set; }
    }

在设计器中效果如下:



对应的JavaScript处理代码, 使用 executeCustomCommandObject 方法执行命令属性中的命令。

class MyPluginCommand extends Forguncy.Plugin.CommandBase{
    execute() {
        const noticeDiv = $("<div style='width: 300px;top:-300px;right:20px;background:#FBF3DB;position:absolute;padding:10px'>有新的任务需要处理!<br>点击处理<div>");
        $(document.body).append(noticeDiv);
        noticeDiv.animate({ top: '10px' }, 300);
        noticeDiv.click(() => {
            const command = this.CommandParam.ClickNoticeCommand;
            this.executeCustomCommandObject(command); // 执行命令中定义的单击命令
        });
        setTimeout(() => {
            noticeDiv.animate({ top: '-300px' }, 200, () => {
                noticeDiv.remove();
            });
        }, 3000);
    }
}

Forguncy.Plugin.CommandFactory.registerCommand("MyPlugin.MyPluginCommand, MyPlugin", MyPluginCommand);

如果需要更细致的控制,需要使用CustomCommandObjectAttribute标注来控制。

1. 支持上下文参数

  1. 设置CustomCommandObjectAttribute 的 InitParamValues 和 InitParamProperties 属性,多个上下文变量可以用“|”分隔。

  2. 代码:

        public class MyPluginCommand : Command
        {
            [CustomCommandObject(InitParamProperties = "context", InitParamValues = "上下文")]
            public object ClickNoticeCommand { get; set; }
        }
  3. 设计器效果:


  4. JavaScript 添加上下文参数处理。

    class MyPluginCommand extends Forguncy.Plugin.CommandBase{
        execute() {
            const noticeDiv = $("<div style='width: 300px;top:-300px;right:20px;background:#FBF3DB;position:absolute;padding:10px'>有新的任务需要处理!<br>点击处理<div>");
            $(document.body).append(noticeDiv);
            noticeDiv.animate({ top: '10px' }, 300);
            noticeDiv.click(() => {
                const command = this.CommandParam.ClickNoticeCommand;
                const initPrarm = {};
                initPrarm[command.ParamProperties["context"]] = "MyContext";// 设置上下文值
                this.executeCustomCommandObject(command, initPrarm); // 执行命令中定义的单击命令
            });
            setTimeout(() => {
                noticeDiv.animate({ top: '-300px' }, 200, () => {
                    noticeDiv.remove();
                });
            }, 3000);
        }
    }
    
    Forguncy.Plugin.CommandFactory.registerCommand("MyPlugin.MyPluginCommand, MyPlugin", MyPluginCommand);

2. 上下文参数支持添加描述

  1. 设置CustomCommandObjectAttribute 的 ParameterDescriptions 属性。

  2. 代码:

        public class MyPluginCommand : Command
        {
            [CustomCommandObject(InitParamProperties = "context", InitParamValues = "上下文",
                                ParameterDescriptions = "context:可以在上下文中包含了对应数据的ID")]
            public object ClickNoticeCommand { get; set; }
        }
  3. 设计器效果:

    image

  4. 说明:

    • 添加适当的描述可以帮助用户更好的理解上下文变量的意义。

    • 可以只给部分上下文变量添加注释。

    • 本特性要求活字格版本大于等于9.0.100.0。