第1章 µC/GUI的介绍

Size: px

Start display at page:

Download "第1章 µC/GUI的介绍"

颂徐
5 years ago
Views:

1 控件可以创建和独立使用, 因为它们自己天生就是窗口可是, 使用对话框常常是很需要的, 它是一种包含一个或多个控件的窗口一个对话框通常是一个窗口, 它的出现要求使用者输入信息它可能包括多个控件, 通过对这些不同的控件的选择向使用者发出请求信息, 或者它采用一个提供简单信息 ( 例如提醒使消息框用者注意或警告 ) 和一个 OK 按钮的形式第 1 页

2 14.1 对话框基础 1. 输入焦点视察管理器能记住一个窗口或窗口物体最终被选择是通过用户使用触摸屏, 鼠标, 键盘或者其它的什么一个窗口收到键盘输入消息了, 我们说它有了输入焦点记住输入焦点的主要原因是为了确定键盘命令发送到哪去了具有输入焦点的窗口会接收由键盘产生的事件 2. 模块化和非模块化对话框对话窗口分为模块化和非模块化两种一个模块化对话框会阻塞执行的线程默认情况下, 它有输入焦点, 必须在线程继续执行前被用户关闭另一方面, 一个非模块化对话框不会阻塞调用的线程 -- 在它显示的时候, 它允许任务继续运行请注意在其它的一些环境中, 模块化和非模块化对话框分别被称为模态和非模态 3. 对话框消息一个对话框就是一个窗口, 它接收消息, 就象系统中其它所有窗口做的一们大多数消息被对话框自动处理了, 其它传给了在建立对话框上指定的回调函数 ( 也为对话框程序所知 ) 有两种类型的附加消息被送到对话窗口处理 :WM_INIT_DIALOG 和 WM_NOTIFY_PARENT 在一个对话框显示前,WM_INIT_DIALOG 消息会立即被发送到对话框处理, 而对话框程序对它典型的用法是用这个消息初始化控件, 及实现其它影响对话框显示的初始化任务 WM_NOTIFY_PARENT 消息是通过对话框的子窗口发送到对话框的, 通知父窗口一些为了保证同步的事件 14.2 建立对话框建立对话框需要做两件基本的事情 : 一个资源表, 定义包括的控件, 和一个对话框程序, 定义控件的初始值, 与它们的行为一样一旦两个条件都存在, 你只需进行单个函数调用 (GUI_CreateDialogBox() 或 GUI_ExecDialogBox()) 实际建立对话框 1. 资源表第 2 页对话框可以基于阻塞 ( 使用 GUI_ExecDialogBox()) 或非阻塞 ( 使用

3 GUI_CreateDialogBox()) 方式建立必须首先定义一个资源表, 以指定包括在对话框中的所有控件下面的范例展示如何建立一个资源表这个特定的范例是手工建立的, 尽管它也能通过一个 GUI-builder 做到 static const GUI_WIDGET_CREATE_INFO_aDialogCreate[] = FRAMEWIN_CreateIndirect, Dialog,0,10,10,180,230,0,0, BUTTON_CreateIndirect, OK,GUI_ID_OK,100,5,60,20,0,0, BUTTON_CreateIndirect, Cancel,GUI_ID_CANCEL,100,30,60,20,0,0, TEXT_CreateIndirect, LText,0,10,55,48,15,0,GUI_TA_LEFT, TEXT CreateIndirect, RText,0,10,80,48,15,0,GUI_TA_RIGHT, EDIT_CreateIndirect,NULL,GUI_ID_EDIT0,60,55,100,15,0,50, EDIT_CreateIndirect,NULL,GUI_ID_EDIT1,60,80,100,15,0,50, TEXT_CreateIndirect, Hex,0,10,100,48,15,0,GUI_TA_RIGHT, EDIT_CreateIndirect,NULL,GUI_ID_EDIT2,60,100,100,15,0,6, TEXT_CreateIndirect, Bin,0,10,120,48,15,0,GUI_TA_RIGHT, EDIT_CreateIndirect,NULL,GUI_ID_EDIT3,60,120,100,15,0,0, LISTBOX_CreateIndirect,NULL,GUI_ID_LISTBOX0,10,20,48,40,0,0, CHECKBOX_CreateIndirect,NULL,GUI_ID_CHECK0,10,5,0,0,0,0, CHECKBOX_CreateIndirect,NULL,GUI_ID_CHECK1,30,5,0,0,0,0, SLIDER_CreateIndirect,NULL,GUI_ID_SLIDER0,60,140,100,20,0,0, SLIDER_CreateIndirect,NULL,GUI_ID_SLIDER1,10,170,150,30,0,0 ; 2. 对话框程序 /*************************************************************************** * 对话框程序 * ***************************************************************************/ static void_cbcallback(wm_message * pmsg) switch(pmsg->msgid) default: WM_DefaultProc(pMsg); 第 3 页

对于这个范例, 随着下面一行代码的执行, 对话框会显示出来 GUI_ExecDialogBox( _adialogcreate, GUI_COUNTOF(_aDialogCreate), &_cbcallback, 0, 0, 0); 结果的对话框看起来如下图一样, 或者与之相似 ( 实际外观依赖于你的配置和默认设置 ): 建立对话框后, 所有包括在资源表中的控件将可见,

4 对于这个范例, 随着下面一行代码的执行, 对话框会显示出来 GUI_ExecDialogBox( _adialogcreate, GUI_COUNTOF(_aDialogCreate), &_cbcallback, 0, 0, 0); 结果的对话框看起来如下图一样, 或者与之相似 ( 实际外观依赖于你的配置和默认设置 ): 建立对话框后, 所有包括在资源表中的控件将可见, 尽管看起来与上面的屏幕截图差不多, 这样控件是以空的形式出现这是因为对话框程序依旧没有包括初始化单个元素的代码控件的初始化数值, 由它们引起的行为, 以及它们之间的交互作用都需要在对话框程序中定义 3. 初始化对话框最典型的下一步是使用它们各自的初始化数值对控件进行初始化在对话框程序中, 这是对 WM_INIT_DIALOG 消息做出反应时的通常做法下面的程序说明这个事情 : /*************************************************************************** * 对话框程序 * ***************************************************************************/ static void_cbcallback(wm_message * pmsg) int NCode, Id; WM_HWIN hedit0, hedit1, hedit2, hedit3, hlistbox; 第 4 页

5 WM_HWIN hwin = pmsg->hwin; switch(pmsg->msgid) case WM_INIT_DIALOG: /* 获得所有控件的窗口句柄 */ hedit0 = WM_GetDialogItem(hWin, GUI_ID_EDIT0); hedit1 = WM_GetDialogItem(hWin, GUI_ID_EDIT1); hedit2 = WM_GetDialogItem(hWin, GUI_ID_EDIT2); hedit3 = WM_GetDialogItem(hWin, GUI_ID_EDIT3); hlistbox = WM_GetDialogItem(hWin, GUI_ID_LISTBOX0); /* 初始化所有控件 */ EDIT_SetText(hEdit0, EDIT widget 0 ); EDIT_SetText(hEdit1, EDIT widget 1 ); EDIT_SetTextAlign(hEdit1, GUI_TA_LEFT); EDIT_SetHexMode(hEdit2, 0x1234, 0, 0xffff); EDIT_SetBinMode(hEdit3, 0x1234, 0, 0xffff); LISTBOX_SetText(hListBox,_apListBox); WM_DisableWindow(WM_GetDialogItem(hWin, GUI_ID_CHECK1)); CHECKBOX_Check(WM_GetDialogItem(hWin, GUI_ID_CHECK0)); CHECKBOX_Check(WM_GetDialogItem(hWin, GUI_ID_CHECK1)); SLIDER_SetWidth(WM_GetDialogItem(hWin, GUI_ID_SLIDER0), 5); SLIDER_SetValue(WM_GetDialogItem(hWin, GUI_ID_SLIDER1), 50); break; default: WM_DefaultProc(pMsg); 初始化后的对话现在看起来象下面的一样了, 所有的控件都有了初始数值 : 第 5 页

6 4. 定义对话框行为对话框一旦被初始化, 剩下的所有要向对话框程序添加的代码将定义控件的行为, 使其可充分的操作继续同一个范例, 最终的对话框程序如下所示 : /*************************************************************************** * 对话框程序 * ***************************************************************************/ static void_cbcallback(wm_message * pmsg) int NCode, Id; WM_HWIN hedit0, hedit1, hedit2, hedit3, hlistbox; WM_HWIN hwin = pmsg->hwin; switch(pmsg->msgid) case WM_INIT_DIALOG: /* 获得所有控件的窗口句柄 */ hedit0 = WM_GetDialogItem(hWin, GUI_ID_EDIT0); hedit1 = WM_GetDialogItem(hWin, GUI_ID_EDIT1); hedit2 = WM_GetDialogItem(hWin, GUI_ID_EDIT2); hedit3 = WM_GetDialogItem(hWin, GUI_ID_EDIT3); hlistbox = WM_GetDialogItem(hWin, GUI_ID_LISTBOX0); /* 初始化所有控件 */ EDIT_SetText(hEdit0, EDIT widget 0 ); EDIT_SetText(hEdit1, EDIT widget 1 ); EDIT_SetTextAlign(hEdit1, GUI_TA_LEFT); 第 6 页

7 EDIT_SetHexMode(hEdit2, 0x1234, 0, 0xffff); EDIT_SetBinMode(hEdit3, 0x1234, 0, 0xffff); LISTBOX_SetText(hListBox,_apListBox); WM_DisableWindow(WM_GetDialogItem(hWin, GUI_ID_CHECK1)); CHECKBOX_Check(WM_GetDialogItem(hWin, GUI_ID_CHECK0)); CHECKBOX_Check(WM_GetDialogItem(hWin, GUI_ID_CHECK1)); SLIDER_SetWidth(WM_GetDialogItem(hWin, GUI_ID_SLIDER0), 5); SLIDER_SetValue(WM_GetDialogItem(hWin, GUI_ID_SLIDER1), 0); break; case WM_KEY: switch(((wm_key_info*)(pmsg->data.p))->key) case GUI_ID_ESCAPE: GUI_EndDialog(hWin, 1); break; case GUI_ID_ENTER: GUI_EndDialog(hWin, 0); break; break; case WM_NOTIFY_PARENT: Id = WM_GetId(pMsg->hWinSrc); /* 控件的 Id */ NCode = pmsg->data.v; /* 通知代码 */ switch(ncode) case WM_NOTIFICATION_RELEASED: /* 如果释放则起作用 */ if(id == GUI_ID_OK) /* OK 按钮 */ GUI_EndDialog(hWin, 0); if(id == GUI_ID_CANCEL) /* Cancel 按钮 */ GUI_EndDialog(hWin, 1); break; case WM_NOTIFICATION_SEL_CHANGED: /* 改变选择 */ FRAMEWIN_SetText(hWin, Dialog - sel changed ); 第 7 页

8 break; default: FRAMEWIN_SetText( break; default: WM_DefaultProc(pMsg); hwin, Dialog-notification received ); 码想了解更详细的资料, 请参考随 µc/gui 一起发布的范例中的 Dialog.c 这个范例的全部代 14.3 对话框 API 参考函数下表列出了与对话框相关的函数, 在各自的类型中按字母顺序进行排列函数的详细描述后面列出函数 GUI_CreateDialogBox GUI_ExecDialogBox GUI_EndDialog GUI_MessageBox 说明对话框建立一个非阻塞式的对话框建立一个阻塞式的对话框结束一个对话框消息框建立一个消息框 14.4 对话框 GUI_CreateDialogBox 描述建立一个非阻塞式的对话框函数原型 WM_HWIN GUI_CreateDialogBox ( const GUI_WIDGET_CREATE_INFO* pawidget, int NumWidgets, 第 8 页

9 WM_CALLBACK* cb, WM_HWIN hparent, int x0, int y0); 参数含意 pawidget 定义包含在对话框中所有控件的资源表的指针 NumWidgets 包含在对话框中所有控件的数量 cb 一个具体应用的回调函数的指针 ( 对话框程序 ) hparent 父窗口的句柄 (0 表示没有父窗口 ) x0 对话框相对于父窗口的 X 轴坐标 y0 对话框相对于父窗口的 Y 轴坐标 GUI_ExecDialogBox 描述建立一个阻塞式的对话框函数原型 int GUI_ExecDialogBox ( const GUI_WIDGET_CREATE_INFO* pawidget, int NumWidgets, WM_CALLBACK* cb, WM_HWIN hparent, int x0, int y0); 参数含意 pawidget 定义包含在对话框中所有控件的资源表的指针 NumWidgets 包含在对话框中所有控件的数量 cb 一个具体应用的回调函数的指针 ( 对话框程序 ) hparent 父窗口的句柄 (0 表示没有父窗口 ) x0 对话框相对于父窗口的 X 轴坐标 y0 对话框相对于父窗口的 Y 轴坐标 GUI_EndDialog 描述结束 ( 关闭 ) 一个对话框第 9 页

10 函数原型 void GUI_EndDialog(WM_HWIN hdialog, int r); 参数 hdialog 含意对话框的句柄返回数值从建立对话框的函数 ( 只是与 GUI_ExecDialogBox 相关 ) 指定返回调用任务的数值对于非阻塞方式的对话框, 没有等待的应用任务, 则返回值被忽略 14.5 消息框消息框实际上是一种对话框, 只不过是它的默认属性被指定了它只需要一行代码就能建立一条消息显示在一个带标题栏的窗框内, 同时带有一个 OK 按钮, 要关闭窗口必需按下它 GUI_MessageBox 描述建立及显示一个消息框函数原型 void GUI_MessageBox(const char* smessage, const char* scaption, int Flags); 参数 smessage scaption Flags 含意显示的消息窗口框标题栏的标题内容为以后的扩展而保留, 数值无关紧要附加信息消息框的默认特性可以通过修改 GUIConf.h 文件中相关内容而改变下表显示了所有可用的配置宏 : 类型宏默认值说明 N MESSAGEBOX_BORDER 4 消息框元素和客户窗框元素之间的距离 N MESSAGEBOX_XSIZEOK 50 OK 按钮的 X 轴尺寸第 10 页

11 N MESSAGEBOX_YSIZEOK 20 OK 按钮的 Y 轴尺寸 S MESSAGEBOX_BKCOLOR GUI_WHITE 客户窗口的背景颜色消息框显示的内容多于一行是可以的下面的范例展示如何做到这一点范例下面的例子展示了一个简单消息框的用法 /* 文件 : DIALOG_MessageBox.c 目的 : 展示 GUI_MessageBox 的例子 */ #include GUI.h /*************************************************************************** * 主函数 * ***************************************************************************/ void main(void) GUI_Init(); WM_SetBkWindowColor(GUI_RED); /* 建立消息框, 并等待至其关闭 */ GUI_MessageBox( This text is shown\nin a message box, Caption/Title, GUI_MESSAGEBOX_CF_MOVEABLE); GUI_Delay(500); /* 等待一小段时间 */ GUI_MessageBox( New message!, Caption/Title, GUI_MESSAGEBOX_CF_MOVEABLE); 上面范例程序执行结果的屏幕截图第 11 页

12 第 12 页

月光迴旋曲

月光迴旋曲臺北人, 淡江大學中文所畢曾任電腦雜誌採編電視臺執行製作高職專任導師, 曾獲耕莘四十週年臺灣之顏文學獎 2007 全國臺灣文學營創作獎第二十四屆聯合文學小說新人獎第九屆暨第十二屆臺北文學獎九十九年教育部文藝創作獎第