【emWin实战教程V2.0】第51章 实用的官方小键

席萌0209

完整65章+12章附件教程下载地址：
http://www.armbbs.cn/forum.php?mod=viewthread&tid=19834

第51章      实用的官方小键盘实例讲解

        初学者经常问这方面的问题，特此将官方的这个小键盘例子跟大家进行讲解，非常具有代表性，极具参考价值。
        51.1 初学者重要提示
        51.2 官方WIDGET_NumPad.c实例
        51.3 总结

51.1  初学者重要提示


        本章节没有提供开发板上面运行的例子，如果要在开发板上面运行官方的这个例子，直接将所有内容复制粘贴到本教程配套的任意例子的MainTask.C文件里面，这个文件里面之前的内容全部删掉即可。

51.2 官方WIDGET_NumPad.c实例

        这个例子在模拟器中的位置：

主要功能介绍：
        本例子很好的演示了数字小键盘的实现方法。主界面上面创建了两个对话框，一个对话框上面创建了两个编辑框控件，为了方便说明，我们将其命名为对话框A，另一个对话框上面创建了15个按钮，用于给对话框A上面的编辑框发送消息，我们将其命名为对话框B。实现这个小键盘功能，有两个关键点，初次学习时一定要认识到。
        1、通过对话框B上面的15个按钮给对话框A的编辑框发送消息是通过函数GUI_SendKeyMsg来发送键盘消息的。编辑框控件支持接收的键盘消息已经在第50章的50.2.2小节里面进行讲解。
        2、对话框B上面的15个按钮控件一定要设置禁止聚焦，并将对话框B上面的编辑框控件设置为聚焦，因为只有聚焦的控件才可以接收键盘消息，这个问题我们在讲解每个控件的时候都有强调。将按钮控件设置为禁止聚焦是因为用户一旦触摸了按钮控件，这个按钮会被聚焦，由于同一时刻只有一个控件能够聚焦，编辑框上面的聚焦就消失了，使用函数GUI_SendKeyMsg发送的按键消息将无法传达到编辑框上面。
程序代码如下：

1. #include "DIALOG.h"
3. /*********************************************************************
4. *
5. *       Defines
6. *
7. **********************************************************************
8. */
9. //
10. // Recommended memory to run the sample with adequate performance
11. //
12. #define RECOMMENDED_MEMORY (1024L * 10)
14. /*********************************************************************
15. *
16. *       Static data
17. *
18. **********************************************************************
19. */
20. //
21. // Bitmap data for arrow keys
22. //
23. static GUI_CONST_STORAGE GUI_COLOR _aColorsArrow[] = {
24.   0xFFFFFF, 0x000000
25. };
27. static GUI_CONST_STORAGE GUI_LOGPALETTE _PalArrow = {
28.   2, /* number of entries */
29.   1,     /* No transparency */
30.   &_aColorsArrow[0]
31. };
33. static GUI_CONST_STORAGE unsigned char _acArrowRight[] = {
34.   ____XX__, ________,
35.   ____XXXX, ________,
36.   XXXXXXXX, XX______,
37.   ____XXXX, ________,
38.   ____XX__, ________
39. };
41. static GUI_CONST_STORAGE unsigned char _acArrowLeft[] = {
42.   ____XX__, ________,
43.   __XXXX__, ________,
44.   XXXXXXXX, XX______,
45.   __XXXX__, ________,
46.   ____XX__, ________
47. };
49. static GUI_CONST_STORAGE GUI_BITMAP _bmArrowRight = {
50.   10,            /* XSize */
51.   5,             /* YSize */
52.   2,             /* BytesPerLine */
53.   1,             /* BitsPerPixel */
54.   _acArrowRight, /* Pointer to picture data (indices) */
55.   &_PalArrow     /* Pointer to palette */
56. };
58. static GUI_CONST_STORAGE GUI_BITMAP _bmArrowLeft = {
59.   10,            /* XSize */
60.   5,             /* YSize */
61.   2,             /* BytesPerLine */
62.   1,             /* BitsPerPixel */
63.   _acArrowLeft,  /* Pointer to picture data (indices) */
64.   &_PalArrow     /* Pointer to palette */
65. };
66. //
67. // Array of keys
68. //
69. static int _aKey[] = {GUI_KEY_DELETE, GUI_KEY_TAB, GUI_KEY_LEFT, GUI_KEY_RIGHT};  //--------------（1）
71. //
72. // Dialog resource of numpad
73. //
74. static const GUI_WIDGET_CREATE_INFO _aDialogNumPad[] = {   //--------------（2）
75. //
76. //  Function                 Text      Id                 Px   Py   Dx   Dy
77. //
78.   { WINDOW_CreateIndirect,   0,        0,                225, 110,  95, 130},
79.   { BUTTON_CreateIndirect,   "7",      GUI_ID_USER +  7,   5,   5,  25,  20},
80.   { BUTTON_CreateIndirect,   "8",      GUI_ID_USER +  8,  35,   5,  25,  20},
81.   { BUTTON_CreateIndirect,   "9",      GUI_ID_USER +  9,  65,   5,  25,  20},
82.   { BUTTON_CreateIndirect,   "4",      GUI_ID_USER +  4,   5,  30,  25,  20},
83.   { BUTTON_CreateIndirect,   "5",      GUI_ID_USER +  5,  35,  30,  25,  20},
84.   { BUTTON_CreateIndirect,   "6",      GUI_ID_USER +  6,  65,  30,  25,  20},
85.   { BUTTON_CreateIndirect,   "1",      GUI_ID_USER +  1,   5,  55,  25,  20},
86.   { BUTTON_CreateIndirect,   "2",      GUI_ID_USER +  2,  35,  55,  25,  20},
87.   { BUTTON_CreateIndirect,   "3",      GUI_ID_USER +  3,  65,  55,  25,  20},
88.   { BUTTON_CreateIndirect,   "0",      GUI_ID_USER +  0,   5,  80,  25,  20},
89.   { BUTTON_CreateIndirect,   ".",      GUI_ID_USER + 10,  35,  80,  25,  20},
90.   { BUTTON_CreateIndirect,   "Del",    GUI_ID_USER + 11,  65,  80,  25,  20},
91.   { BUTTON_CreateIndirect,   "Tab",    GUI_ID_USER + 12,   5, 105,  25,  20},
92.   { BUTTON_CreateIndirect,   0,        GUI_ID_USER + 13,  35, 105,  25,  20},
93.   { BUTTON_CreateIndirect,   0,        GUI_ID_USER + 14,  65, 105,  25,  20},
94. };
96. //
97. // Dialog resource of user dialog
98. //
99. static const GUI_WIDGET_CREATE_INFO _aDialogUser[] = {  //--------------（3）
100. //
101. //  Function                 Text      Id                 Px   Py   Dx   Dy
102. //
103.   { FRAMEWIN_CreateIndirect, "Dialog", 0,                 40,  90, 140, 115, FRAMEWIN_CF_MOVEABLE},
104.   { EDIT_CreateIndirect,     0,        GUI_ID_EDIT0,      10,  10, 110,  20, 0, 12},
105.   { EDIT_CreateIndirect,     0,        GUI_ID_EDIT1,      10,  40, 110,  20, 0, 12},
106.   { BUTTON_CreateIndirect,   "Ok",     GUI_ID_OK,         10,  70,  50,  20 },
107.   { BUTTON_CreateIndirect,   "Cancel", GUI_ID_CANCEL,     70,  70,  50,  20 },
108. };
110. //
111. // Title of sample
112. //
113. static char _aTitle[] = {"WIDGET_NumPad"};
115. //
116. // Explanation of sample
117. //
118. static char * _apExplain[] = {
119.   "This sample shows how to use a numpad as input",
120.   "device. This can be useful if no keyboard",
121.   "is available and the user should edit numeric",
122.   "values or text on a touch screen.",
123. };
125. /*********************************************************************
126. *
127. *       Static code
128. *
129. **********************************************************************
130. */
131. /*********************************************************************
132. *
133. *       _cbDialogNumPad
134. *
135. * Function description
136. *   Callback function of the numpad.
137. */
138. static void _cbDialogNumPad(WM_MESSAGE * pMsg) {  //--------------（4）
139.   GUI_RECT r;
140.   unsigned i;
141.   int      NCode;
142.   unsigned Id;
143.   int      Pressed;
144.   WM_HWIN  hDlg;
145.   WM_HWIN  hItem;
147.   Pressed = 0;
148.   hDlg = pMsg->hWin;
149.   switch (pMsg->MsgId) {
150.   case WM_PAINT:    //--------------（5）
151.     WM_GetClientRect(&r);
152.     GUI_SetColor(0x000000);
153.     GUI_DrawRect(r.x0, r.y0, r.x1, r.y1);          /* Draw rectangle around it */
154.     /* Draw the bright sides */
155.     GUI_SetColor(0xffffff);
156.     GUI_DrawHLine(r.y0 + 1, r.x0 + 1, r.x1 - 2);   /* Draw top line */
157.     GUI_DrawVLine(r.x0 + 1, r.y0 + 1, r.y1 - 2);
158.     /* Draw the dark sides */
159.     GUI_SetColor(0x555555);
160.     GUI_DrawHLine(r.y1-1, r.x0 + 1, r.x1 - 1);
161.     GUI_DrawVLine(r.x1-1, r.y0 + 1, r.y1 - 2);
162.     break;
163.   case WM_INIT_DIALOG:  //--------------（6）
164.     for (i = 0; i < GUI_COUNTOF(_aDialogNumPad) - 1; i++) {
165.       hItem = WM_GetDialogItem(hDlg, GUI_ID_USER + i);
166.       BUTTON_SetFocussable(hItem, 0);  /* Set all buttons non focussable */  //--------------（7）
167.       switch (i) {
168.       case 13:
169.         BUTTON_SetBitmapEx(hItem, 0, &_bmArrowLeft, 7, 7);  /* Set bitmap for arrow left button (unpressed) */
170.         BUTTON_SetBitmapEx(hItem, 1, &_bmArrowLeft, 7, 7);  /* Set bitmap for arrow left button (pressed) */
171.         break;
172.       case 14:
173.         BUTTON_SetBitmapEx(hItem, 0, &_bmArrowRight, 7, 7); /* Set bitmap for arrow right button (unpressed) */
174.         BUTTON_SetBitmapEx(hItem, 1, &_bmArrowRight, 7, 7); /* Set bitmap for arrow right button (pressed) */
175.         break;
176.       }
177.     }
178.     WM_GetDialogItem(hDlg, GUI_ID_USER + 12);
179.     break;
180.   case WM_NOTIFY_PARENT:
181.     Id    = WM_GetId(pMsg->hWinSrc);      /* Id of widget */
182.     NCode = pMsg->Data.v;                 /* Notification code */
183.     switch (NCode) {
184.     case WM_NOTIFICATION_CLICKED:     //--------------（8）
185.       Pressed = 1;
186.     case WM_NOTIFICATION_RELEASED:    //--------------（9）
187.       if ((Id >= GUI_ID_USER) && (Id <= (GUI_ID_USER + GUI_COUNTOF(_aDialogNumPad) - 1))) {
188.         int Key;
189.         if (Id < GUI_ID_USER + 11) {
190.           char acBuffer[10];
191.           BUTTON_GetText(pMsg->hWinSrc, acBuffer, sizeof(acBuffer)); /* Get the text of the button */
192.           Key = acBuffer[0];
193.         } else {
194.           Key = _aKey[Id - GUI_ID_USER - 11]; /* Get the text from the array */
195.         }
196.         GUI_SendKeyMsg(Key, Pressed);  /* Send a key message to the focussed window */
197.       }
198.       break;
199.     }
200.   default:
201.     WM_DefaultProc(pMsg);
202.   }
203. }
205. /*********************************************************************
206. *
207. *       _cbDialogUser
208. *
209. * Purpose:
210. *   Callback function of the user dialog.
211. */
212. static void _cbDialogUser(WM_MESSAGE * pMsg) {  //--------------（10）
213.   int      i;
214.   int      NCode;
215.   int      Id;
216.   WM_HWIN  hDlg;
217.   WM_HWIN  hItem;
219.   hDlg = pMsg->hWin;
220.   switch (pMsg->MsgId) {
221.   case WM_INIT_DIALOG:
222.     for (i = 0; i < 2; i++) {   //--------------（11）
223.       hItem = WM_GetDialogItem(hDlg, GUI_ID_EDIT0 + i);  /* Get the handle of the edit widget */
224.       EDIT_SetText(hItem, "12345678");                   /* Set text */
225.     }
226.     break;
227.   case WM_NOTIFY_PARENT:
228.     Id    = WM_GetId(pMsg->hWinSrc);      /* Id of widget */
229.     NCode = pMsg->Data.v;                 /* Notification code */
230.     switch (NCode) {
231.       case WM_NOTIFICATION_RELEASED:      /* React only if released */  //--------------（12）
232.         if (Id == GUI_ID_OK) {            /* OK Button */
233.           GUI_EndDialog(hDlg, 0);
234.         }
235.         if (Id == GUI_ID_CANCEL) {        /* Cancel Button */
236.           GUI_EndDialog(hDlg, 1);
237.         }
238.         break;
239.     }
240.     break;
241.   default:
242.     WM_DefaultProc(pMsg);
243.   }
244. }
246. /*********************************************************************
247. *
248. *       _cbDesktop
249. *
250. * Function description
251. *   This routine handles the drawing of the desktop window.
252. */
253. static void _cbDesktop(WM_MESSAGE * pMsg) {  //--------------（13）
254.   unsigned i;
256.   switch (pMsg->MsgId) {
257.   case WM_PAINT:
258.     GUI_SetBkColor(GUI_RED);
259.     GUI_Clear();
260.     GUI_SetFont(&GUI_Font24_ASCII);
261.     GUI_DispStringHCenterAt(_aTitle, 160, 5);
262.     GUI_DispNextLine();
263.     GUI_SetFont(GUI_DEFAULT_FONT);
264.     GUI_DispNextLine();
265.     for (i = 0; i < GUI_COUNTOF(_apExplain); i++) {
266.       GUI_DispStringHCenterAt(_apExplain[i], 160, GUI_GetDispPosY());
267.       GUI_DispNextLine();
268.     }
269.     break;
270.   }
271. }
273. /*********************************************************************
274. *
275. *       Exported code
276. *
277. **********************************************************************
278. */
279. /*********************************************************************
280. *
281. *       MainTask
282. */
283. void MainTask(void) {
284.   WM_HWIN hNumPad;
286.   GUI_Init();
287.   //
288.   // Check if recommended memory for the sample is available
289.   //
290.   if (GUI_ALLOC_GetNumFreeBytes() < RECOMMENDED_MEMORY) {
291.     GUI_ErrorOut("Not enough memory available.");
292.     return;
293.   }
294.   WM_SetCallback(WM_HBKWIN, _cbDesktop);  //--------------（14）
295.   hNumPad = GUI_CreateDialogBox(_aDialogNumPad,
296.                                 GUI_COUNTOF(_aDialogNumPad),  //--------------（15）
297.                                 _cbDialogNumPad, WM_HBKWIN, 0, 0); /* Create the numpad dialog */
298.   WM_SetStayOnTop(hNumPad, 1);
299.   while (1) {
300.     GUI_ExecDialogBox(_aDialogUser,      //--------------（16）
301.                       GUI_COUNTOF(_aDialogUser),
302.                       _cbDialogUser, WM_HBKWIN, 0, 0);             /* Execute the user dialog */
303.     GUI_Delay(1000);
304.   }
305. }

复制代码

1.     对话框上15个按钮中，最后四个按钮可以发送的键盘消息。
2.     创建了15个按钮的对话框上的资源列表，为了方便描述，我们将其命名为对话框B。
3.     创建了两个编辑框和两个按钮的对话框上的资源列表，为了方便描述，我们将其命名为对话框A。
4.     对话框B的回调函数。
5.     对话框B回调函数的WM_PAINT消息，主要是重绘背景显示效果。
6.     对话框B回调函数的WM_INIT_DIALOG消息，主要是初始化控件。
7.     对话框B上面的所有按钮控件都被设置禁止聚焦。
8.     对话框B上面按钮的点击消息，这个消息里面设置了变量Pressed =1，表示按钮按下。特别注意这个消息里面没有加break语句，也就是会继续往下执行：

1. /* 确定这15个按键的ID是否在范围内 */           
2.    if ((Id >= GUI_ID_USER) && (Id <= (GUI_ID_USER + GUI_COUNTOF(_aDialogNumPad) - 1))) {
3.         int Key;
4.      /* 按钮的ID在范围GUI_ID_USER + 0到GUI_ID_USER + 10这11个按钮的消息处理 */
5.         if (Id < GUI_ID_USER + 11) {
6.           char acBuffer[10];
7.           /* 获得此按钮上面显示的字符 */
8.           BUTTON_GetText(pMsg->hWinSrc, acBuffer, sizeof(acBuffer));
9.           Key = acBuffer[0];
10.         }
11.          /* 按钮的ID在范围GUI_ID_USER + 11到GUI_ID_USER + 14这4个按钮的消息处理 */
12. else {
13. /* 获得此按钮对应的键盘消息，即全局变量_aKey里面存的4个键盘消息 */
14.           Key = _aKey[Id - GUI_ID_USER - 11];
15.         }
17.      /* 发送消息给当前聚焦的窗口，即对话框A上面的编辑框控件，此时Pressed = 1表示按下消息 */
18.         GUI_SendKeyMsg(Key, Pressed);  *
19.       }

复制代码

9.     对话框B上面按钮的释放消息，功能跟第8条相同，唯一不同的是这里发送的键盘释放消息，在这个回调函数的开头已经设置变量Pressed = 0，所以使用函数GUI_SendKeyMsg发送的时候，发送的是释放消息。
10.  对话框A的回调函数。
11.  对话框A回调函数的WM_INIT_DIALOG消息，主要是初始化控件，这里是初始化编辑框上面显示的字符。
12.  对话框A上面两个按钮的回调消息处理，都是通过函数GUI_EndDialog来关闭对话框。不同的是第二个参数，这个参数设置的数值是作为阻塞式对话框的返回值。
13.  桌面窗口的回调函数。
14.  设置桌面窗口的回调函数。
15.  创建对话框B。
16.  创建对话框A。
实际显示效果如下：

51.3 总结


        本章节为大家讲解的这个例子非常具有代表性，建议初学者尝试做一个自己的小键盘，并在开发板上面测试运行。