RT-Thread-RTGUI教程之四：widgetRT-Thread问答社区

RTGUI教程之四：widget

发布于 2009-12-10 23:42:08 浏览：3210 订阅该版

=====================
RTGUI教程之四：widget
=====================

widget意为小玩意，小器件。在GUI中，这个泛指图形上的基本元素，例如按钮，标签，文本输入框等。

这一章就说说RTGUI里的widget，而且主要集中在RTGUI里的各个图形元素的最底层的、最基本的元素。

----------------
RTGUI Widget结构
----------------

widget结构定义放在rtguiincludewidgetswidget.h 中，是一个相对大型的结构：
```struct rtgui_widget
{
   /* 从rtgui_object继承而来 */
    struct rtgui_object object;

/* 父控件和根控件 */
    struct rtgui_widget *parent, *toplevel;
    /* 控件兄弟列表 */
    rtgui_list_t sibling;

/* 控件的参数 */
    rt_int32_t flag;
    /* 控件的对齐方式 */
    rt_int32_t align;

/* 控件的图形上下文（前景色、背景色等，这个是每个控件都独立的） */
    rtgui_gc_t gc;

/* 控件的外观信息 */
    rtgui_rect_t extent;
    /* 控件的最小宽度和最小高度 */
    rt_int16_t mini_width, mini_height;
    rt_int16_t margin, margin_style;

/* 控件的剪切域 */
    rtgui_region_t clip;
    /* 控件的剪切域同步标志 */
    rt_uint32_t clip_sync;

/* 控件的事件处理函数，默认指向rtgui_widget_event_handler，可重载为其他值 */
    rt_bool_t (*event_handler)    (struct rtgui_widget* widget, struct rtgui_event* event);

/* 一些回调函数 */
    rt_bool_t (*on_draw)        (struct rtgui_widget* widget, struct rtgui_event* event);
    rt_bool_t (*on_focus_in)    (struct rtgui_widget* widget, struct rtgui_event* event);
    rt_bool_t (*on_focus_out)    (struct rtgui_widget* widget, struct rtgui_event* event);
    rt_bool_t (*on_mouseclick)    (struct rtgui_widget* widget, struct rtgui_event* event);
    rt_bool_t (*on_key)            (struct rtgui_widget* widget, struct rtgui_event* event);
    rt_bool_t (*on_size)        (struct rtgui_widget* widget, struct rtgui_event* event);
    rt_bool_t (*on_command)        (struct rtgui_widget* widget, struct rtgui_event* event);
};
typedef struct rtgui_widget rtgui_widget_t;
```
从结构中，我们可以大致看到几类信息：
控件树的维护节点，parent、toplevel、sibling
图形相关的信息，gc、align、extent等
剪切域信息，clip和clip_sync

然后是为了重载用的事件处理函数，以及一些回调函数（当一些特定的事件发生时，进行相应的回调函数调用）

-------------
RTGUI的控件树
-------------

RTGUI的各个控件是采用树形方式组织的，一般的widget可以看成一个个叶子，但从它派生的类，例如container，则具备了容纳子widget的能力。container是非常重要的一个类，看看它的结构定义：

```struct rtgui_container
{
    /* 从rtgui_widget继承而来  */
    struct rtgui_widget parent;

/* container的焦点widget   */
    struct rtgui_widget* focused;
    /* container包含的子widget */
    rtgui_list_t children;
};
typedef struct rtgui_container rtgui_container_t;
```
好了，有了container的结构定义，就可以看看RTGUI里的控件树：
![rtgui_widget_tree.png](/uploads/53_f55713349ae6d32a17715d28b69030cf.png)
widget间的兄弟节点依靠sibling连接，子节点依靠container的children连接。

---------------
RTGUI的几个控件
---------------

从代码里可以看得出，绝大多数类是从rtgui_widget派生而来的，而所有的控件类都是从widget中派生的：
- workbench，工作台，附加在各个panel上，一个workbench就等于一个RT-Thread线程。view，视图，附加在workbench上（可多个视图附加在一个workbench上）。
- window，窗口，可以是完全独立的窗口（必须附加在一个RT-Thread线程上）；也可以是关联在workbench上的窗口（事件处理在workbench的事件处理循环中进行）。
- toplevel控件，绘图上最顶层的控件，workbench和window类都是从它派生的。
- container控件，能够包容子控件的控件容器，toplevel，view从它派生。
- widget控件，所有控件类的基类。
- button，label，textbox等，具体的控什