高仿富途牛牛-组件化(五)-如何去管理炒鸡多的小窗口

目录

一、概述

代码写的久了，什么功能都想搞点儿模式。不知道是不是只有我一个人这么想的，做功能时不在是只为了完成功能，而是在完成功能的同时会去考虑可扩展性怎么样？哪块儿的代码可以复用？又或者哪里需要留更多的接口？这两个类之间是不是可以加一个协作类？总之各种想法都出来了。

假设说有这样一种场景，我们通过一个入口界面，上边有很多种按钮，当我们点击上边的按钮时，程序就会生成一个小窗口。这些小窗口他们的外在行为基本一致，只是窗口里边展示的内容各不一样。

总结一下应该是这样的

• 窗体可以通过标题栏进行拖拽
• 鼠标移动到边界可以进行放大缩小
• 鼠标选中时边框高量显示
• 标题栏具有名称、关闭和各种各样的菜单
• 不同功能窗体的菜单内容不一样，展示风格也可能完全不同
• 标题栏和中心窗体也有交互
• 连续点击一个按钮时，生成同类型的窗体不能完全覆盖

用过富途牛牛的同学应该对这个功能比较清楚一点，富途中的交易模块也是如此，工具箱里支持各种小窗体生成，并且都有各自丰富的内容。

这么多繁杂的窗体，富途是怎么管理的呢？

本篇文章就来仔细挖掘下这个功能，我们也来实现一个小窗口管理功能。

二、效果展示

如效果图所示，我们之前所说的几个功能点都已经有了，并且在配色上比之前的demo程序也有改善，当然要投入使用还是需要设计师同学经过专业的指点。

三、功能类

为了实现这个窗口管理功能，思考的头都快要炸掉了，不是因为功能有多复杂，而是作为一个开发人员，我想的太多了，总是会出现一种幻觉，产品经理可能会提出这样那样的新需求，测试也可能会给你报一个莫名其妙的问题。

最最关键的还是我们要对自己写的代码有一个基本要求。结构必须合理、减少冗余和耦合，让其他人阅读代码时使用最小的成本，

为了做这个窗口管理功能，我也是想了好久，总是想着设计的更合理一些，别人在使用时就会更简单一些，使用成本也会更小。

为此，我引入了好几个关键类，都是辅助管理窗口的，下面先来一张类图，这是我使用staruml画的，不是特别规范，主要是为了说明这些类的功能，以及他们之间的一个关系，图上都用注释写出了每个类的大概作用。

从图上也可以看出来，类中就是一个简单的名字，我没有把类的接口都贴上去，一个是时间问题，另一个我也觉着不是特别有必要，因为我本身对这个画图工具使用就不是特别深入，所以这里就只提供了简单的版本。大家凑合看吧，对理解设计思路还是有很大的帮助。

本篇文章主要讲的是小窗口管理，但是这里主要是通过讲述迷你报价小窗口来说明怎么去管理炒鸡多的小窗口

从上边图中可知，关键类有以下这些

1. ismall：业务窗口接口类，负责和smallwidget进行通信
2. minipricesmall：迷你报价小窗口的中心窗口
3. smallwidget：小窗口模板类，这是所有小窗口的外壳类，包含了标题栏。迷你报价窗口就是构造了这么一个类，然后设置了一个中心窗口minipricesmall。其他的业务窗口都是使用同样的模式
4. viewmodepanel：迷你报价工具菜单按下时，弹出的视图列表，主要是为了修改显示模式。仔细观察效果展示中的gif图，菜单'm'被点击时，弹出了显示模式窗口，随后在显示模式窗口任意选项上单击后，迷你报价窗口上都出现了一行欢迎文本--感谢您的使用，您选择了模式:x
5. smallcontext：小窗口管理上下文类，主要负责处理我们定制好的外壳类smallwidget和业务窗口minipricesmall(其他更多业务窗口)之间的消息通信
6. smallgroup：小窗口组管理者，主要负责磁力吸附这个功能，详情参看这篇文章
7. smallfactory：小窗口工厂，负责构造各式各样的小窗口
8. toolboxdialog：工具箱的实现没有专门去写文章讲解，需要了解的可以参看这篇文章，第三小节对工具箱做了简单的讲解

四、设计上的考虑

首先，我自己做的是一个组件化的功能，我需要考虑的东西也是更多的，不仅仅要把功能完成，更多的是要去考虑，别人用的时候代价怎么可以更小？可以复用的代码，我尽量都提取出来，写成共性的东西，其他开发在做相应业务模块时，只需要考虑真的和他们有直接关系的地方。

这里我们就拿迷你报价这个功能来说事，看看怎么去设计是合理的，或者说目前看起来是合理的，可能后期根据需求，我们的结构或许会进行一定的调整。

1、功能拆分

单独拿出一个迷你报价功能来说，可能100%的人都会说很简单，这有什么难的，我刚参加工作那会儿百度百度也都能做出来。可是往往把一些简单的东西，抽象抽来，让程序变得更简单这件事情本身就是一件比较难的事情。

迷你报价这个窗口总的来说可以分为上下两部分：上边标题栏和下面内容展示区域

标题栏

标题栏是每一个小窗口都有的，因此这里我们肯定是要单独提出来作为一个公有的东西，当其他开发做自选股、小时钟、短线精灵这些小窗口时，标题栏的移动事件他们就根本不需要考虑了。

细心的同学可能会发现了，标题栏上还有一些不认识的按钮，这些按钮时干什么的呢？

虽然标题栏已经被公有化，但是标题栏上的按钮可不是这么想的，他们的行为要根据底部内容窗口的类型决定，因此这里就有了一定的变化。

为了适应这个变化，我自己定义了一个接口类ismall，主要是让内容窗口进行继承的，也就是说内容窗口需要重写这个接口类的一些接口，来完成运行时的一些设定。

比如说，迷你报价标题栏按钮显示有哪些？按钮显示时都有哪些功能？按钮点击时该有什么样的相应？按钮点击后弹出的面板点击被点击了，内容窗口做何处理等等。

内容展示

内容展示窗口就比较简单了，这里有2个选择，继承ismall接口类或者不继承

1. 继承-意味着内容窗口需要和外壳窗口进行消息通信
2. 不继承-我们就只是展示数据的，不需要进行消息通信

事实上大多数的内容窗口都是需要继承ismall这个接口类的，纯展示而没有交互的功能几乎没有。

2、关键类

ismall

ismall接口类是毫无疑问的关键类，它是一个纯虚类，继承它的类都必须实现它的所有接口，如下代码所示

/**
* 简介： 小窗口上的回调事件，需要通知中心窗体
*/
struct ismallcall
{
    virtual viewmode viewtype(smalltooltype) = 0;
    virtual void getitems(qvector<dataitem> &) = 0;
    virtual qsize getsize() const = 0;
    virtual void notify(const qstring &) = 0;
};

getsize()、getitems()这些接口都是获取数据接口，外壳类smallwidget，会根据当前中心窗口返回的定制数据去初始化自己。

比如说效果图中展示的显示模式面板，这个面板中的数据内容，就是迷你报价类minipricesmall重写了getitems接口之后，给外壳类提供的数据，并且制定了事件触发时使用的显示模式为视图。

迷你报价类重写的数据准备接口如下

void minipricesmall::getitems(qvector<dataitem> & items)
{
    for (int i = 0; i < 9; ++i)
    {
        dataitem item;
        item.name = 'a' + i;
        item.type = item.name;
        item.img = "./image/mainwindow/tquant-btn_normal.png";
        items.append(item);
    }
}

目前接口类中的接口还不是特别完善，根据后续业务功能的变化，接口肯定还会继续增多。

minipricesmall

这个类是迷你报价的数据展示类，他继承自qwidget窗口类和ismall接口类，界面搭建这里我就不说了，两个原因：其一是这里的界面本身就是空的，其二也是比较关键的，中心窗口的内容是根据业务类型决定的，后期根据不同开发负责的功能自己去搭建。通常情况下这里都是别人已经封装好了的控件，有必要的时候在使用一个简单外壳类包一层即可。

除过界面之外，就是ismall的接口实现类了，一部分接口是给外部smallwidget提供数据的，而另一部分接口就是响应外部事件。

目前来说，响应外部接口事件就只有一个接口notify，比较重要，消息响应时根据参数来区分消息类型

smallwidget

小窗口类，为所有小窗口的外壳类，提供了定制化的标题栏和边界缩放。功能实现不难，需要的可自行百度。

viewmodepanel

显示模式面板，主要是一些小窗口可以根据该面板的选项可以进行显示模式的重组，并且可以切换窗体的大小等等。效果展示中我们只是修改了显示的问题，不过实现起来思路是一样的，最主要的是内容窗体已经接收到我们传递的消息。

smallcontext

这是一个比较关键的类，当时想了很久，到底要不要加。

这个类主要负责的功能就是同步小窗体外壳类smallwidget和内容窗体类之间的消息传递。

• 当smallwidget想要给内容窗体传递消息时，会通过ismall接口类进行发送指令，因为内容窗体是继承了这个ismall接口类的
• 当内容窗体想给外壳发送消息时，是通过ismall的接口调用来到达目的的，严格来说其实是外壳窗体主动跟内容窗体要的消息内容。

当sunpanel面板通过工厂类smallfactory进行构造小窗口时，会把smallwidget和构造好的内容窗体进行注册，并开始接收smallwidget发送过来的事件请求。

void smallcontext::registersmallwidget(smallwidget * widget, ismallcall * call)
{
    m_itemmap[widget] = call;

    connect(widget, &smallwidget::clickedbutton, this, &smallcontext::handleevent);
}

当工具栏点击了'm'按钮时，smallwidget就会给smallcontext发送事件请求，并附带相关参数，这里smallwidget发送了显示模式选择事件，下面是smallcontext的处理方式

void smallcontext::handleevent(int type, const qpoint & globalpos)
{
    if (smallwidget * widget = dynamic_cast<smallwidget *>(sender()))
    {
        if (m_itemmap.contains(widget))
        {
            if (ismallcall * call = m_itemmap[widget])
            {
                viewmode view = call->viewtype(smalltooltype(type));

                if (view == vm_view)
                {
                    showview(widget, call, globalpos);
                }
            }
        }
    }
}

smallfactory

最后就是工厂类了，一看名字就知道，他是一个工厂，专门负责生产小窗口的，对工具箱来说，他只知道给subpanel发送显示一个小窗口这个指令，但是subpanel自己其实也不会去真正的构造一个小窗口，原因其实很简单，单个的构造一个小窗体其实没问题，但是当小窗体种类多起来时，需要维护的消息就随之增多。

重构之后的代码看起来像这样，当subpanel类需要一个小窗口时，他只需要这么干就行

smallwidget * smallwidget = m_psmallfactory->createwidget(type, subcontent);
subcontent->addsmallwidget(smallwidget);

smallwidget->move(m_psmallfactory->getpos(type, subcontent));
smallwidget->show();

调用工程的createwidget方法，构造一个小窗口，然后加入到自己的布局中

这里还有一个比较关键的问题，就是窗口初始位置管理，我们在工厂里维护了一个位置偏移量，当连续请求同一类型的小窗口时，我们会给这个偏移量增加一个固定值，使得连续请求时，同一类型的小窗口获取到的位置是有规律的变化

void smallfactory::updateoffset(bool change, qwidget * parent)
{
    if (change)
    {
        m_offset += qpoint(13, 13);
    }
    else
    {
        m_offset = qpoint(0, 0);
    }

    qrect r = parent->rect();
    if ( m_offset.y() > r.height() / 4 
        || m_offset.x() > r.width() / 4)
    {
        m_offset *= -1;
        m_offset.setx(m_offset.x() - 15);
    }
}

五、相关文章

---

很重要--转载声明

1. 本站文章无特别说明，皆为原创，版权所有，转载时请用链接的方式，给出原文出处。同时写上原作者： or twowords

2. 如要转载，请原文转载，如在转载时修改本文，请事先告知，谢绝在转载时通过修改本文达到有利于转载者的目的。

---