004 Laura.SqlForever如何扩展 导航栏 工具栏 右键菜单 插件
导航栏 插件扩展
比如下图的 窗口 > 关闭所有文档 这个导航栏;
在 任何程序集,任何命名空间,任何类名 扩展类似插件:
代码详解:
特性标签: Key: 唯一键值(同名键值 会以 Important 权重,相互覆盖)
ParentKey: 父级键值
GroupKey: 在导航栏中,某些 选项按钮 存在分组,这个值 就是 分组用的
Order: 排序值(降序)
TriggerType: 触发窗体类型(即 这个 选项是 为 哪一类 窗体服务的——支持基类)
BarItemType: 是 导航栏 还是 工具栏
判断启用函数:Must 和 CanUse 这两个 函数基本算是 历史遗留 —— 但不是错误,且依然有效!
>Must 是 当前扩展 启用底限 —— 只有满足 Must 条件,才能启用;
>CanUse 是 当前扩展 启用状态 —— 比方说,对应窗体改变,而 影响 当前扩展 启用状态;
>上面的代码 Must 函数中,判断 当前扩展 只为 MainForm 服务;
>但是 特性标签 中 TriggerType 已经写明:触发类型 为 MainForm —— 即 判断重复。
>这个 判断重复 是 Laura.XtraFramework 升级时留下的,作者很懒。
触发事件委托:BarItemHandler 实现了 当前扩展 在界面上 被 单击时 的触发事件;
>导航栏、工具栏 更多的是 按钮型选项;
>如果 你的 当前扩展 在 导航栏、工具栏 不是一个 按钮 —— 而是一个 下拉列表 等 特殊模式呢?
>BarItemInfoBase 基类 已经预留了函数,这里只简单介绍,具体实现 各位有兴趣就阅读源码咯:
>改写 SelfHandler 属性,直接 返回 true —— 当前扩展 自己处理事件(不麻烦 架构参与);
>改写 GetUI 函数,这个函数 默认返回 按钮类型 —— 你可以自定义 返回 下拉列表类型;
>Ps. GetUI 函数,支持 当前选项的 子级控制 —— GetUI 是 完全* 的;
工具栏 插件扩展
比如下图的 脚本执行窗体 > 链接数据库引擎 这个 工具栏按钮;
在 任何程序集,任何命名空间,任何类名 扩展类似插件:
右键菜单 插件扩展
我们这里 以 树形导航 中的 节点的 右键举例
在 任何程序集,任何命名空间,任何类名 扩展类似插件:
代码详解
>特性 + 基类: 这个 和上面 主要 思想是类似的;但是没有 TriggerType;
>Must + CanUse 函数: 控制 当前扩展 的启用状态;
>MenuStripHandler 委托: 右键菜单 的 触发事件;
>历史遗留:
>基类 MenuStripItemBase,特性 MenuStripAttribute
在 Laura.WinFramework 中 导航栏 、 右键菜单 都可以使用;
但在 Luara.Windows.XtraForms 中仅 右键菜单 可以使用(现在的 导航栏扩展 上面已经介绍);
> 这种历史 遗留,完全是 底层布局控件库 的不同而导致,确也无奈;
历史遗留的 工具栏扩展
上面已经介绍:
>Laura.WinFramework: 导航栏+右键菜单(MenuStripItemBase) 工具栏(ToolStripItemBase)
>Laura.XtraFramework: 导航栏+工具栏(BarItemInfoBase) 右键菜单(历史MenuStripItemBase)
特殊工具栏(历史 ToolStripItemBase)
为什么 还要保留 历史工具栏扩展:
>看图说话:
>红色区域 里面的是 最新的 BarItemInfoBase 扩展的工具栏;
>蓝色区域 里面的是 历史的 ToolStripItemBase 扩展的工具栏;
> DevExpress 控件库 扩展工具栏 需要引用 太多组件 —— 用到 蓝色区域 反而显得庞大,不够简洁;
>历史 的 工具栏扩展方式 反而在这里 显得简单 —— 于是 最后还是将 历史的工具栏 予以了保留;
最后
在 Laura.SqlForever 的 升级,扩展 过程中,终究 有所剥夺,也有所增添。
为了 Laura.XtraFramework 稳定 和 强大,一些 之前思想 终究 保留了下来。
这些 历史遗留 我们在 《005 Laura.SqlForever历史遗留 的 架构思想缺陷.doc》中再 详细指出。
舒小龙
2014-02-13 00:12