QT Embedded二三事之QWSWindow

在前面QWSServer文章中,已经提到一个QWSClient代表一个QApplication。QWSServer还管理着一组QWSClient的对象，那就是toplevel widget,即顶层窗口。QWSWindow对象就是toplevel widget在QWSServer中的代表。在QWSServer中或者说在整个QT中，window是指toplevel widget，因此QWSServer中只使用window不使用widget这个词语。
    QWSServer用一个QWSWindow的数组管理着所有客户端的toplevel widget。
    QPtrList windows; // first=topmost

    下面从QWSWindow的属性方法以及与QWidget的交互过程，详细说明一下。
    1.QWSWindow的属性
    QWSWindow中保存了toplevel widget的如下主要属性：
    (1) winId和client 
    winId是QWSServer分配每个toplevel widget的标识，全局唯一，非负int。非toplevel widget也有winId,但是client私有，而且是个负值。
    client是用来标识toplevel widget所属的客户端。一个client应用是不能管理另一个client的窗口。也查询也不行。这个比较严格。
    (2)name,caption
    用来标识一个toplevel widget的两个属性
 
    (3)requst_region
    这是client端为这个toplevel widget请求的region大小。

    (4)allocated_region,alloc_region_idx
    allocated_region是QWSServer端分配这个toplevel widget的region. 所有toplevel widget的region 都放在一个QWSRegionManager中管理，alloc_region_idx是分给这个toplevel widget的regionId。

    (5)exposed
    exposed是在region变化过程中toplevel widget新获得的region，用来优化重画区域，只有这块区域才有必要重画。

    (6)onTop
    onTop表明toplevel widget是否具有alwaysOnTop的属性。

    2.QWSWindow的方法
    针对如上属性，QWSWindow提供如下方法来管理这些属性。
    (1)setName setCaption :name caption

    (2)raise,lower,show,hide
    改变toplevel widget的altitude属性，altitude属性体现在QWSServer的QPtrList windows变量：从高到低排列，windows[0]最高。

    (3)setActiveWindow
    ActiveWindow是相对于toplevel widget才有的概念，就是指有focus的toplevel widget。

    从QWSWindow的属性和方法来看，严格来说，QWSWindow并非toplevel widget的代表，QWSWindow只是负责管理toplevel widget的三个主要属性:region,altitude,active(focus)。其它的属性并不管理，如：
    (1)toplevel widget创建时,QWSWindow并未创建，只有等到toplevel widget请求region或altitude或focus时才会导致QWSWindow的创建(QWSServer::findWindow)。
    (2)可以为每个toplevel widget设置单独的property，这是由QWSServer的QWSPropertyManager对象管理的。

    另个需要说明的一点，window或者widget的visible属性是指window/widget有没有show过，并不是指在屏幕能不能看到。show过的window或widget都会有一个request_region，用来衡量是否visible的标准是requestion_region.isEmpty()。从屏幕上能不能看到是由allocate_requestion来决定。requestion_region不为空，但是可能被其它的window挡住，导致QWSServer分配的allocate_region为空。

    3.QWSWindow与QWidget的交互
    即然QWSWindow只管理toplevel widget的region,altitude,focus.
    (1)focus
    client:
    QWidget::setActiveWindow/QWidget::showWindow/QWidget::hideWindow --> QWSDisplay::requestFocus -->send QWSRequestFocusCommand to server
    server:
    recieve QWSRequestFocusCommand-->QWSServer::invokeFocus-->QWSServer::setFocus -->send QWSFocusEvent to cient

    client:
    recieve QWSFocusEvent-->QApplication::qwsProcessEvent(QWSEvent::focus)

    (2)altitude和region
    导致这两个属性变化的操作很多，主要有    QWidget::showWindow/QWidget::hideWindow/QWidget::raise/QWidget::lowser/QWidget/QWiget::move......
    处理流程和focus类似，最终客户端会收到QWSRegionModifiedEvent事件。

    需要说明的一点，altitude的改变与会导致region的改变，这两个是有关系的。但是这两个和focus确没关系，从focus的原理来看，有focus的window并不一定是altitude最高的，甚至不一定是从屏幕上看的到的。容易造成误解。 在QWidget::showWindow中，先调用requestRegion和setAltitude，再调用requestFocus。这是造成这个问题的根源，调用requestFocus之前，可能有另一个应用的window调用requestionRegion或setAltitude把先前的window覆盖了，这样QWSServer在处理requestFocus时，获得focus的窗口就不定可以从屏幕上看得见了。

    至此,toplevel widget通过QWSWindow获取region/focus以及相应的QWSEvent事件，剩下的绘图工作，就由QWidget根据自已的需要完成了。