RT-Thread RTOS组件：RTGUI教程 Hello World

发布于 2009-10-21 09:09:11 浏览：4848 订阅该版

这是RTGUI的一份系列教程

第一篇：GUI的Hello World

RTGUI设计得与其他GUI是不相类似的，所以很有必要建立一些基本概念。RTGUI内部是完全线程化的，显示一个UI必须依赖于一个线程的上下文，因为后台存在一个GUI Server的服务端进行辅助的服务。这个GUI Server必须要知道，它服务的客户端位于哪个线程中。

接下来的例子中会在屏幕上显示一个窗口，窗口内部显示“Hello World“的文本字符。

例子代码：
void msg(void)
{
	/* UI依赖于一定的线程环境，具体的，它依赖于一个消息队列，这个消息队列会接收来自GUI Server的请求信息 */
	rt_mq_t mq;  /* mq即这个消息队列 */
	rt_thread_t tid;
	rt_uint32_t user_data;
	struct rtgui_win* msgbox;  /* 显示一个消息窗口，这里是它相应的窗口指针 */
	struct rtgui_rect rect = {50, 50, 200, 200};  /* 窗口的显示位置 */

/* UI中，消息是在线程间传递的，所以接收消息的消息队列需要紧贴到线程中去，RT-Thread中用到了线程的私有字段：user_data */
	tid = rt_thread_self();
	if (tid == RT_NULL) return; /* 获得当前线程，如果当前线程是空，即调度器未启动，UI不能使用，直接返回 */
	user_data = tid->user_data; /* 先保存老的user_data */

/* 创建一个256 x 4的消息队列  */
	mq = rt_mq_create("msgbox", 256, 4, RT_IPC_FLAG_FIFO);
	/* 注册消息队列mq到当前线程上 */
	rtgui_thread_register(tid, mq);

/* 创建窗口，参数包含父控件，窗口标题、窗口位置（注意窗口的标题、边框是由GUI Server维护的，所以实际上大小要大上一圈），风格参数 */
	msgbox = rtgui_win_create(RT_NULL, "Information", &rect, RTGUI_WIN_STYLE_DEFAULT);
	if (msgbox != RT_NULL)
	{
		/* box是个盒子，更是一个布局的引擎，内部的空间不需要指定位置，可以由box自动布局 */
		struct rtgui_box* box = rtgui_box_create(RTGUI_VERTICAL, RT_NULL);
		struct rtgui_label* label = rtgui_label_create("Hello World"); /* 创建Hello World的标签 */

rtgui_win_set_box(msgbox, box); /* 设置窗口的布局盒子 */
		RTGUI_WIDGET(label)->align = RTGUI_ALIGN_CENTER_HORIZONTAL | RTGUI_ALIGN_CENTER_VERTICAL; /* 标签的布局风格，垂直、水平居中 */
		rtgui_widget_set_miniwidth(RTGUI_WIDGET(label),130); /* 设置标签的最小长度 */
		rtgui_box_append(box, RTGUI_WIDGET(label)); /* 添加标签到盒子中 */
		rtgui_box_layout(box); /* 当所有控件添加完时，显式调用layout做盒子的自动布局 */

rtgui_win_show(msgbox); /* 显示这个窗口 */
	}

rtgui_win_event_loop(msgbox); /* 执行窗口的事件循环 */

/* 能够走到这步，就意味着，这个窗口已经关闭了 */

rtgui_thread_deregister(tid); /* 去注册当前线程 */
	/* 删除相应的消息队列 */
	rt_mq_delete(mq);

/* 恢复用户数据 */
	tid->user_data = user_data;
}
FINSH_FUNCTION_EXPORT(msg, msg on gui);

执行这个函数，UI截图：
[attach]0[/attach]

在finsh下执行这个函数，有个非常明显的特点，即执行后，finsh就不再响应命令，因为finsh shell的线程已经作为UI线程来使用。有时，UI可能也会有那种自动弹出对话框的提示，显示一段时间后，自动关闭。看看这个在RTGUI中应该如何来实现的：

/* 因为要跨函数访问，所以把下面这些作为全局变量 */
static struct rtgui_timer *timer;
static struct rtgui_label* label;
static struct rtgui_win* msgbox;
static rt_uint8_t label_text[80];
static int cnt = 5;

/* 显示对话框后的定时器超时回调函数，和RT-Thread中的timer不相同，这个超时函数的执行上下文是显示对话框线程的上下文 */
void diag_close(struct rtgui_timer* timer, void* parameter)
{
	rt_sprintf(label_text, "closed then %d second!", cnt);
	
	/* 重新设置标签文本 */
	rtgui_label_set_text(label, label_text);
	/* 调用update函数更新显示 */
	rtgui_widget_update(RTGUI_WIDGET(label));
	if (cnt == 0)
	{
		/* 当cnt减到零时，删除对话框 */
		rtgui_win_destroy(msgbox);
		rtgui_timer_stop(timer);
                /* 删除定时器 */
		rtgui_timer_destory(timer);
	}

cnt --;
}

void msg()
{
	rt_mq_t mq;
	rt_thread_t tid;
	rt_uint32_t user_data;
	struct rtgui_rect rect = {50, 50, 200, 200};

tid = rt_thread_self();
	if (tid == RT_NULL) return; /* can't use in none-scheduler environement */
	user_data = tid->user_data;

/* create gui message queue */
	mq = rt_mq_create("msgbox", 256, 4, RT_IPC_FLAG_FIFO);
	/* register message queue on current thread */
	rtgui_thread_register(rt_thread_self(), mq);

msgbox = rtgui_win_create(RT_NULL, "Information", &rect, RTGUI_WIN_STYLE_DEFAULT);
	if (msgbox != RT_NULL)
	{
		struct rtgui_box* box = rtgui_box_create(RTGUI_VERTICAL, RT_NULL);

cnt = 5;
		rt_sprintf(label_text, "closed then %d second!", cnt);
		label = rtgui_label_create(label_text);

rtgui_win_set_box(msgbox, box);
		RTGUI_WIDGET(label)->align = RTGUI_ALIGN_CENTER_HORIZONTAL |
			RTGUI_ALIGN_CENTER_VERTICAL;
		rtgui_widget_set_miniwidth(RTGUI_WIDGET(label),130);
		rtgui_box_append(box, RTGUI_WIDGET(label));
		rtgui_box_layout(box);

rtgui_win_show(msgbox);
	}

/* 多了个定时创建的动作，超时时执行的是diag_close函数 */
	timer = rtgui_timer_create(200, RT_TIMER_FLAG_PERIODIC,
		diag_close, RT_NULL);
	rtgui_timer_start(timer);

rtgui_win_event_loop(msgbox);

rtgui_thread_deregister(rt_thread_self());
	/* remove RTGUI message queue */
	rt_mq_delete(mq);

/* recover user data */
	tid->user_data = user_data;
}
FINSH_FUNCTION_EXPORT(msg, msg on gui)
![rtgui_helloworld.jpg](https://oss-club.rt-thread.org/uploads/53_39239edba54176480663ac90d8906336.jpg)

![GUI.jpg](https://oss-club.rt-thread.org/uploads/414_3e2dd9ef3a49f80e8ef57fc19e5f78e9.jpg)