特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接

第50章 MULTIEDIT-多行文本控件

    本期教程讲解STemWin支持的多行文本控件。

    50. 1 多行文本控件介绍

    50. 2 官方WIDGET_Multiedit实例

    50. 3 使用uCGUIBulder建立多行文本控件

    50. 4 总结

50.1 多行文本控件介绍

    通过MULTIEDIT小工具可编辑多行文本。它既可以被用作简单的文本编辑器，也可以用来显示静态文本。该小工具支持带滚动条和不带滚动条的滚动。下表显示MULTIEDIT小工具的外观：

50.1.1 多行文本支持的通知代码

    以下事件是多行文本控件作为WM_NOTIFY_PARENT消息的一部分发送给其父窗口的：

消息	描述
WM_NOTIFICATION_CLICKED	已单击小工具。
WM_NOTIFICATION_RELEASED	已释放小工具。
WM_NOTIFICATION_MOVED_OUT	已单击小工具，并且指针已移出小工具，但没有释放。
WM_NOTIFICATION_SCROLL_CHANGED	可选滚动条的滚动位置已更改。
WM_NOTIFICATION_VALUE_CHANGED	小工具的文本已更改。

50.1.2 多行文本支持的键盘反应

    如果控件具有输入焦点，则它将对下列各键做出反应：

按键	反应
GUI_KEY_UP	将光标向上移动一行。
GUI_KEY_DOWN	将光标向下移动一行。
GUI_KEY_RIGHT	将光标向右移动一个字符。
GUI_KEY_LEFT	将光标向左移动一个字符。
GUI_KEY_END	将光标移到当前行的末尾。
GUI_KEY_HOME	将光标移到当前行的开头。
GUI_KEY_BACKSPAC	如果小工具在读/写模式下工作，此按键将删除光标之前的字符。
GUI_KEY_DELETE	如果小工具在读/写模式下工作，此按键将删除光标之下的字符。
GUI_KEY_INSERT	在插入模式和覆盖模式之间切换。
GUI_KEY_ENTER	如果小工具在读/写模式下工作，此按键将在当前位置插入一个新行(’\n’)。如果小工具在只读模式下工作，光标将移到下一行的开头。

50.2 官方WIDGET_Multiedit实例

    官方的这个实例很好的演示了Multiedit的使用，这个例子在模拟器中的位置：

源码如下（程序中进行了详细的注释，代码有点长，这里只贴出了主代码）：

1. /*********************************************************************
   
2. *
   
3. * _DemoMultiedit
   
4. */
   
5. static void _DemoMultiedit(void) {
   
6. GUI_RECT Rect;
   
7. int WinFlags;
   
8. 
   
9. _hFrame = 1;
   
10. _Overwrite = 0;
    
11. _ReadOnly = 0;
    
12. _Password = 0;
    
13. 
    
14. /* 下面的几个函数主要实现框架窗口的创建 */
    
15. _ChangeInfoText("Create framewin", SPEED);
    
16. /* 创建框架窗口 */
    
17. _hFrame = FRAMEWIN_CreateEx(60, 80, 200, 120, WM_HBKWIN, WM_CF_SHOW, 0, 0, "Notepad", 0);
    
18. /* 获得框架窗口的客户端窗口 */
    
19. _hClient = WM_GetClientWindow(_hFrame);
    
20. /* 设置框架窗口的回调函数 */
    
21. _pcbFrameWin = WM_SetCallback(_hFrame, _cbFrameWin);
    
22. /* 设置框架窗口中客户端窗口的回调函数 */
    
23. _pcbFrameWinClient = WM_SetCallback(_hClient, _cbFrameWinClient);
    
24. 
    
25. /* 设置框架窗口的属性 */
    
26. FRAMEWIN_SetMoveable(_hFrame, 1);
    
27. FRAMEWIN_SetActive(_hFrame, 1);
    
28. FRAMEWIN_SetTextAlign(_hFrame, GUI_TA_HCENTER | GUI_TA_VCENTER);
    
29. FRAMEWIN_SetFont(_hFrame, &GUI_Font8x12_ASCII);
    
30. FRAMEWIN_SetTitleHeight(_hFrame, 16);
    
31. 
    
32. /* 增加框架窗口按钮，主要是关闭，最小化，最大化按钮 */
    
33. if (_ChangeInfoText("Add framewin buttons", SPEED)) return;
    
34. FRAMEWIN_AddCloseButton(_hFrame, FRAMEWIN_BUTTON_LEFT, 0);
    
35. FRAMEWIN_AddMaxButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 0);
    
36. FRAMEWIN_AddMinButton(_hFrame, FRAMEWIN_BUTTON_RIGHT, 1);
    
37. WM_InvalidateWindow(_hFrame);
    
38. 
    
39. /* 创建按钮 */
    
40. if (_ChangeInfoText("Add option buttons", SPEED)) return;
    
41. _hWrapButton = _CreateLButton("None", 0, 36, 16, _hClient, ID_NONEWRAP);
    
42. _CreateLButton("Word", 37, 36, 16, _hClient, ID_WORDWRAP);
    
43. _CreateLButton("Char", 74, 36, 16, _hClient, ID_CHARWRAP);
    
44. _CreateRButton("PSW", 52, 25, 16, _hClient, ID_PASSWORD);
    
45. _CreateRButton("OVR", 26, 25, 16, _hClient, ID_OVERWRITE);
    
46. _CreateRButton("R/O", 0, 25, 16, _hClient, ID_READONLY);
    
47. _SetButtonState(_hWrapButton, 1);
    
48. 
    
49. /* 创建框架窗口 */
    
50. if (_ChangeInfoText("using\nMULTIEDIT_CreateEx", SPEED)) return;
    
51. WinFlags = WM_CF_SHOW | WM_CF_ANCHOR_RIGHT | WM_CF_ANCHOR_LEFT | WM_CF_ANCHOR_TOP | WM_CF_ANCHOR_BOTTOM;
    
52. WM_GetClientRectEx(_hClient, &Rect);
    
53. /* 在框架窗口的客户端窗口中创建多行文本控件 */
    
54. _hMEdit = MULTIEDIT_CreateEx(0, 0, 0, Rect.y1 - 16 + 1, _hClient, WinFlags, MULTIEDIT_CF_INSERT, 0, 0, "");
    
55. /* 设置多行文本控件的回调函数 */
    
56. _pcbMultiEdit = WM_SetCallback(_hMEdit, _cbMultiEdit);
    
57. /* 激活自动使用水平滚动条 */
    
58. MULTIEDIT_SetAutoScrollH(_hMEdit, 1);
    
59. /* 激活自动使用垂直滚动条 */
    
60. MULTIEDIT_SetAutoScrollV(_hMEdit, 1);
    
61. /* 设置聚焦 */
    
62. WM_SetFocus(_hMEdit);
    
63. 
    
64. /* 下面主要是演示一下多行文本控件支持的几个API函数 */
    
65. if (_ChangeInfoText("using\nMULTIEDIT_SetText", SPEED)) return;
    
66. /* 设置文本 */
    
67. MULTIEDIT_SetText(_hMEdit, "This sample demonstrates the use of a multiedit widget!");
    
68. 
    
69. /* 设置字体 */
    
70. if (_ChangeInfoText("using\nMULTIEDIT_SetFont", SPEED)) return;
    
71. MULTIEDIT_SetFont(_hMEdit, &GUI_Font16_1);
    
72. 
    
73. /* 设置文本颜色 */
    
74. if (_ChangeInfoText("using\nMULTIEDIT_SetTextColor", SPEED)) return;
    
75. MULTIEDIT_SetTextColor(_hMEdit, 0, 0xE00000);
    
76. 
    
77. /* 设置背景色 */
    
78. if (_ChangeInfoText("using\nMULTIEDIT_SetBkColor", SPEED)) return;
    
79. MULTIEDIT_SetBkColor(_hMEdit, 0, 0xD0FFFF);
    
80. 
    
81. /* 启用字词换行 */
    
82. if (_ChangeInfoText("using\nMULTIEDIT_SetWrapWord", SPEED)) return;
    
83. MULTIEDIT_SetWrapWord(_hMEdit);
    
84. 
    
85. /* 设置字词换行按钮的状态 */
    
86. _SetButtonState(_hWrapButton, 0);
    
87. _hWrapButton = WM_GetDialogItem(_hClient, ID_WORDWRAP);
    
88. _SetButtonState(_hWrapButton, 1);
    
89. 
    
90. /* 用于设置边界 */
    
91. if (_ChangeInfoText("using\nMULTIEDIT_SetHBorder", SPEED)) return;
    
92. MULTIEDIT_SetHBorder(_hMEdit, 3);
    
93. 
    
94. /* 设置提示文本 */
    
95. if (_ChangeInfoText("using\nMULTIEDIT_SetPrompt", SPEED)) return;
    
96. MULTIEDIT_SetPrompt(_hMEdit, "Type: ");
    
97. 
    
98. if (_ChangeInfoText("Play with multiedit...", SPEED)) return;
    
99. 
    
100. while (_hFrame)
     
101. {
     
102. GUI_Delay(100);
     
103. }
     
104. }
     
105. 
     
106. /*********************************************************************
     
107. *
     
108. * public code
     
109. *
     
110. **********************************************************************
     
111. */
     
112. /*********************************************************************
     
113. *
     
114. * MainTask
     
115. */
     
116. void MainTask(void) {
     
117. GUI_Init();
     
118. #if GUI_SUPPORT_MEMDEV
     
119. WM_SetCreateFlags(WM_CF_MEMDEV);
     
120. #endif
     
121. GUI_CURSOR_Show();
     
122. WM_SetCallback(WM_HBKWIN, _cbBkWin);
     
123. while(1) {
     
124. /* 演示多行文本 */
     
125. _DemoMultiedit();
     
126. *_acInfoText = 0;
     
127. WM_InvalidateWindow(WM_HBKWIN);
     
128. GUI_Delay(SPEED);
     
129. }
     
130. }

复制代码

实际显示效果如下：

50.3 使用uCGUIBulder建立多行文本控件

    用uCGUIBulder4.0建立如下界面：

    为列表框添加成员的方法如下：

    将生成的代码直接复制到模拟器或者开发板上面运行，实际显示效果如下（生成的代码在本期教程配套的例子中）：

50.4 总结

    本期教程主要是跟大家讲解了多行文本控件的基础知识。希望大家可以把本期教程中讲的这两个例子跑跑，然后自己设计一个相关的例子进行试验学习。教程中只是使用了部分的多行文本控件API，其它的API大家都可以试试。

谢谢分享 帮顶