这一周可真背，先是硬盘坏了，接着主板都坏了！害得我花了一周的时间才把机器搞好，BREW的环境安装好，这才做了第二个BREW程序。
设置并输出菜单
需求：开发的BREW程序有自己的图标，不使用系统的图标。一进入系统，先是显示一个图标及程序名称。这个画面停留两秒钟后，进入主页面。主页面的结构为：最上面30像素高的地方是显示标题用的；最下面也有三十像素高的地方来显示操作菜单，有确定和退出；然后中间是三个菜单显示的地方。
需求分析及具体实现：
需要定义的变量：在程序中都有详细注释，这里就不多讲了。
需要初始化的东东：因为有两处菜单显示（中间的和底部的），并且这两处菜单的样式等都不一样，所以，在初始化函数里得创建两个IMenuCtl的对象，并且初始化显示这两块菜单的矩形样式。在后面的显示过程中，因为有显示位置的计算，所以再初始化一个整形的变量来存储粗体字的高度。设置一个获取全屏的矩形变量，这在后面多处会用到。
需要释放的东东：因为在SDK里的IMenuCtl接口说明里有提到：不再需要菜单控件，要用IMenuCtl_Release()函数将其释放。所以，在初始化时创建的两个IMenuCtl对象，在最后要释放掉。
一进入程序显示二秒钟的画面，用ISHELL_SetTimer()函数实现。先是将整个屏幕填充背景颜色，然后将图片从数据库里读出，再显示到屏幕的正中。在图片的下边，显示程序的名称（文字和图片之间相隔6像素）。
因为程序中都有详细的注释说明，在这里就不多说了。
需要注意的事项：
标题因为只是文字，所以使用了IDISPLAY_DrawText()方法来绘制。而中间和底部的菜单除了文字，还有系统默认的事件（比如点击手机键盘上的上、下键或使用滚轮，不同的菜单会在选取和不取消选取状态之间切换，等等），所以，得用指向IMenuCtl的指针，并且调用IMenuCtl接口的相关方法来绘制（绘制的相关过程在SDK上都有详细的说明，详情请参见SDK）。
如果是菜单项响应系统事件，那么，就交于系统去处理。处理完成后，仍交于系统即可。每个事件的处理，如果要是处理完毕，还想交给系统处理，就返回FALSE，如果不想系统处理，就返回TRUE，这个时候就代表用户处理完毕，系统将不会处理。对于挂起和恢复的事件，要特别注意的是屏幕需要重新绘制，某些资源需要释放或者是重新载入。
我将绘制标题的动作封装了一个方法，是因为标题在每一页显示基本上都会有。而且，它们都有很多的共性。这样方便我们修改代码，也使流程清晰化。
程序代码如下（省略了大段系统自动生成的注释后）：
代码
1 #include "AEEModGen.h" // Module interface definitions
2 #include "AEEAppGen.h" // Applet interface definitions
3 #include "AEEShell.h" // Shell interface definitions
4
5 #include "AEEMenu.h"
6 #include "menuctltest.brh"
7
8 #include "menuctltest.bid"
9
10 #define MAIN_TITLE_HEIGHT 30//最上面标题的高度
11 #define SOFT_KEY_HEIGHT 30//最下面菜单的高度
12
13 #define RES_STR_MAX_LEN 16//资源文件字符串的最大长度
14
15 #define TITLE_BACK_COLOR MAKE_RGB(28,28,28)//最上面标题栏的背景颜色
16 #define ITEM_BACK_COLOR MAKE_RGB(44,44,44)//中间菜单区域的
17 #define ITEM_TEXT_COLOR MAKE_RGB(255,255,255)//中间菜单文本的颜色
18 #define ITEM_SEL_BACK_COLOR MAKE_RGB(46,90,185)//已经选择文本的背景颜色
19 #define ITEM_SEL_TEXT_COLOR MAKE_RGB(255,255,255)//已经选择文本的字体颜色
20 #define ITEM_FRAME_COLOR MAKE_RGB(83,162,241)//边框颜色
21
22 /*-------------------------------------------------------------------
23 Applet structure. All variables in here are reference via "pMe->"
24 -------------------------------------------------------------------*/
25 // create an applet structure that's passed around. All variables in
26 // here will be able to be referenced as static.
27 typedef struct _menuctltest {
28 AEEApplet a ; // First element of this structure must be AEEApplet
29 AEEDeviceInfo DeviceInfo; // always have access to the hardware device information
30
31 // add your own variables here...
32 IMenuCtl* p_MainMenuCtl;//指向IMenuCtl的指针，用来显示和控制中间主要的菜单项
33 IMenuCtl* p_SoftKeyCtl;//指向IMenuCtl的指针，用来显示和控制底部的菜单项
34 AEERect p_WholeScreen;//定义一个全屏的矩形变量
35 AECHAR p_MainTitle[RES_STR_MAX_LEN];//定义获取标题资源字符串的数组
36 int r_BlodFontHeight;//定义获取粗体字字符高度的变量
37 } menuctltest;
38
39 /*-------------------------------------------------------------------
40 Function Prototypes
41 -------------------------------------------------------------------*/
42 static boolean menuctltest_HandleEvent(menuctltest* pMe,
43 AEEEvent eCode, uint16 wParam,
44 uint32 dwParam);
45 boolean menuctltest_InitAppData(menuctltest* pMe);
46 void menuctltest_FreeAppData(menuctltest* pMe);
47 static void InitMainMenu(menuctltest* pMe);//初始化放置中间主菜单和底部菜单的矩形样式的方法
48 static void ShowAnimation(menuctltest* pMe);//一开始显示程序图标及文字的方法
49 static void ShowMain(menuctltest* pMe);//显示主要界面的方法
50 static void DrawTitle(menuctltest* pMe);//绘制最上面标题文字的方法
51 /*===============================================================================
52 FUNCTION DEFINITIONS
53 =============================================================================== */
54 int AEEClsCreateInstance(AEECLSID ClsId, IShell *pIShell, IModule *po, void **ppObj)
55 {
56 *ppObj = NULL;
57
58 if( ClsId == AEECLSID_MENUCTLTEST )
59 {
60 // Create the applet and make room for the applet structure
61 if( AEEApplet_New(sizeof(menuctltest),
62 ClsId,
63 pIShell,
64 po,
65 (IApplet**)ppObj,
66 (AEEHANDLER)menuctltest_HandleEvent,
67 (PFNFREEAPPDATA)menuctltest_FreeAppData) ) // the FreeAppData function is called after sending EVT_APP_STOP to the HandleEvent function
68
69 {
70 //Initialize applet data, this is called before sending EVT_APP_START
71 // to the HandleEvent function
72 if(menuctltest_InitAppData((menuctltest*)*ppObj))
73 {
74 //Data initialized successfully
75 return(AEE_SUCCESS);
76 }
77 else
78 {
79 //Release the applet. This will free the memory allocated for the applet when
80 // AEEApplet_New was called.
81 IAPPLET_Release((IApplet*)*ppObj);
82 return EFAILED;
83 }
84
85 } // end AEEApplet_New
86
87 }
88
89 return(EFAILED);
90 }
91
92 static boolean menuctltest_HandleEvent(menuctltest* pMe, AEEEvent eCode, uint16 wParam, uint32 dwParam)
93 {
94 //菜单控件对象处理接收事件的系统方法。如果是典型按键按下事件，则将由系统处理；如果不是，后面自己写的代码处理。
95 if( pMe->p_MainMenuCtl && IMENUCTL_HandleEvent( pMe->p_MainMenuCtl, eCode, wParam, dwParam) )
96 return TRUE;
97
98 switch (eCode)
99 {
100 // App is told it is starting up
101 case EVT_APP_START:
102 // Add your code here...
103 ShowAnimation(pMe);
104 return(TRUE);
105
106
107 // App is told it is exiting
108 case EVT_APP_STOP:
109 // Add your code here...
110
111 return(TRUE);
112
113
114 // App is being suspended
115 case EVT_APP_SUSPEND:
116 // Add your code here...
117
118 return(TRUE);
119
120
121 // App is being resumed
122 case EVT_APP_RESUME:
123 // Add your code here...
124
125 return(TRUE);
126
127
128 // An SMS message has arrived for this app. Message is in the dwParam above as (char *)
129 // sender simply uses this format "//BREW:ClassId:Message", example //BREW:0x00000001:Hello World
130 case EVT_APP_MESSAGE:
131 // Add your code here...
132
133 return(TRUE);
134
135 // A key was pressed. Look at the wParam above to see which key was pressed. The key
136 // codes are in AEEVCodes.h. Example "AVK_1" means that the "1" key was pressed.
137 case EVT_KEY:
138 // Add your code here...
139
140 return(TRUE);
141
142
143 // If nothing fits up to this point then we'll just break out
144 default:
145 break;
146 }
147
148 return FALSE;
149 }
150
151
152 // this function is called when your application is starting up
153 boolean menuctltest_InitAppData(menuctltest* pMe)
154 {
155 // Get the device information for this handset.
156 // Reference all the data by looking at the pMe->DeviceInfo structure
157 // Check the API reference guide for all the handy device info you can get
158 pMe->DeviceInfo.wStructSize = sizeof(pMe->DeviceInfo);
159 ISHELL_GetDeviceInfo(pMe->a.m_pIShell,&pMe->DeviceInfo);
160
161 // Insert your code here for initializing or allocating resources...
162 // 创建了两个IMenuCtl对象
163 if( ISHELL_CreateInstance(pMe->a.m_pIShell, AEECLSID_MENUCTL, (void**)(&pMe->p_MainMenuCtl)) != SUCCESS)
164 return FALSE;
165 if( ISHELL_CreateInstance(pMe->a.m_pIShell, AEECLSID_SOFTKEYCTL, (void**)(&pMe->p_SoftKeyCtl)) != SUCCESS)
166 return FALSE;
167
168 //获取粗体字字符的高度
169 pMe->r_BlodFontHeight = IDISPLAY_GetFontMetrics( pMe->a.m_pIDisplay, AEE_FONT_BOLD, NULL, NULL) + 1;
170 //初始化获取全屏的矩形变量
171 SETAEERECT( &pMe->p_WholeScreen, 0, 0, pMe->DeviceInfo.cxScreen, pMe->DeviceInfo.cyScreen);
172 InitMainMenu(pMe);
173 // if there have been no failures up to this point then return success
174 return TRUE;
175 }
176
177 // this function is called when your application is exiting
178 void menuctltest_FreeAppData(menuctltest* pMe)
179 {
180 // insert your code here for freeing any resources you have allocated...
181
182 // example to use for releasing each interface:
183 // if ( pMe->pIMenuCtl != NULL ) // check for NULL first
184 // {
185 // IMENUCTL_Release(pMe->pIMenuCtl) // release the interface
186 // pMe->pIMenuCtl = NULL; // set to NULL so no problems trying to free later
187 // }
188 //
189 //释放IMenuCtl指针资源
190 if ( pMe->p_MainMenuCtl != NULL)
191 {
192 IMENUCTL_Release(pMe->p_MainMenuCtl);
193 pMe->p_MainMenuCtl = NULL;
194 }
195 if( pMe->p_SoftKeyCtl != NULL)
196 {
197 IMENUCTL_Release(pMe->p_SoftKeyCtl);
198 pMe->p_SoftKeyCtl = NULL;
199 }
200 }
201
202 static void InitMainMenu(menuctltest* pMe)
203 {
204 AEEMenuColors colors;
205 AEEItemStyle style1,style2;
206 AEERect rect;
207
208 SETAEERECT( &rect, 0, MAIN_TITLE_HEIGHT, pMe->DeviceInfo.cxScreen, pMe->DeviceInfo.cyScreen - MAIN_TITLE_HEIGHT - SOFT_KEY_HEIGHT);
209 IMENUCTL_SetRect( pMe->p_MainMenuCtl, &rect );
210 SETAEERECT( &rect, 0, pMe->DeviceInfo.cyScreen - SOFT_KEY_HEIGHT, pMe->DeviceInfo.cxScreen, SOFT_KEY_HEIGHT );
211 IMENUCTL_SetRect( pMe->p_SoftKeyCtl, &rect);
212
213 //设置显示文字的样式
214 colors.cBack = ITEM_BACK_COLOR;
215 colors.cText = ITEM_TEXT_COLOR;
216 colors.cSelBack = ITEM_SEL_BACK_COLOR;
217 colors.cSelText = ITEM_SEL_TEXT_COLOR;
218 colors.cFrame = ITEM_FRAME_COLOR;
219 colors.wMask = MC_BACK|MC_TEXT|MC_SEL_BACK|MC_SEL_TEXT|MC_FRAME;
220 IMENUCTL_SetColors( pMe->p_MainMenuCtl, &colors);
221 colors.cBack = TITLE_BACK_COLOR;
222 colors.cText = ITEM_TEXT_COLOR;
223 colors.cSelBack = ITEM_SEL_BACK_COLOR;
224 colors.cSelText = ITEM_SEL_TEXT_COLOR;
225 colors.cFrame = ITEM_FRAME_COLOR;
226 colors.wMask = MC_BACK|MC_TEXT|MC_SEL_BACK|MC_SEL_TEXT|MC_FRAME;
227 IMENUCTL_SetColors( pMe->p_SoftKeyCtl, &colors);
228
229 //设置主菜单和底部菜单已选择的菜单样式和一般菜单样式
230 style1.ft = AEE_FT_NONE;
231 style1.roImage = AEE_RO_NOT;
232 style1.xOffset = 4;
233 style1.yOffset = 4;
234 style2.ft = AEE_FT_BOX;
235 style2.roImage = AEE_RO_NOT;
236 style2.xOffset = 4;
237 style2.yOffset = 4;
238 IMENUCTL_SetStyle(pMe->p_MainMenuCtl, &style1, &style2);
239 IMENUCTL_SetStyle(pMe->p_SoftKeyCtl, &style1, &style2);
240 }
241
242 static void ShowAnimation(menuctltest* pMe)
243 {
244 IImage* p_Image = NULL;
245 AEEImageInfo rImageInfo;
246
247 //读取资源文件里的图片资源
248 p_Image = ISHELL_LoadResImage( pMe->a.m_pIShell, MENUCTLTEST_RES_FILE, IDI_START_IMG);
249
250 if( p_Image)
251 {
252 int x,y;
253 AECHAR tempArr[RES_STR_MAX_LEN];
254
255 //先将要显示开始动画的区域填充颜色
256 IDisplay_FillRect( pMe->a.m_pIDisplay, &pMe->p_WholeScreen, ITEM_BACK_COLOR );
257 //得到图片的相关信息
258 IIMAGE_GetInfo( p_Image, &rImageInfo);
259 //设置图片出现在屏幕上的左上角位置（在屏幕中水平、竖直都居中）
260 x = (pMe->p_WholeScreen.x + pMe->p_WholeScreen.dx - rImageInfo.cx) / 2;
261 y = (pMe->p_WholeScreen.y + pMe->p_WholeScreen.dy - rImageInfo.cy) / 2 - pMe->r_BlodFontHeight;
262 //将图片显示出来
263 IIMAGE_Draw( p_Image, x, y );
264 //读取资源中的文本
265 ISHELL_LoadResString( pMe->a.m_pIShell, MENUCTLTEST_RES_FILE, IDS_START_TITLE, tempArr, RES_STR_MAX_LEN * sizeof(AECHAR));
266 //确定图片下文本的位置
267 x = (pMe->DeviceInfo.cxScreen - IDisplay_MeasureText( pMe->a.m_pIDisplay, AEE_FONT_NORMAL, tempArr)) / 2;
268 y += rImageInfo.cy + 6;
269 //将文本显示出来
270 IDisplay_DrawText( pMe->a.m_pIDisplay, AEE_FONT_NORMAL, tempArr, -1, x, y, NULL, IDF_TEXT_INVERTED | IDF_TEXT_TRANSPARENT);
271 //更新屏幕用于显示
272 IDisplay_Update(pMe->a.m_pIDisplay);
273 //释放IImage对象
274 IImage_Release(p_Image);
275 //设置图片显示时间及显示完成后调用的函数
276 ISHELL_SetTimer( pMe->a.m_pIShell, 2000, (PFNNOTIFY) ShowMain, (void *)pMe);
277 }
278 else
279 {
280 ShowMain(pMe);
281 }
282 }
283
284 static void ShowMain(menuctltest* pMe)
285 {
286 AEERect rect;
287
288 //设置标题的背景矩形并填充颜色
289 SETAEERECT( &rect, 0, 0, pMe->DeviceInfo.cxScreen, MAIN_TITLE_HEIGHT);
290 IDisplay_FillRect( pMe->a.m_pIDisplay, &rect, TITLE_BACK_COLOR);
291 //读取资源文件中的标题文字
292 ISHELL_LoadResString( pMe->a.m_pIShell, MENUCTLTEST_RES_FILE, IDS_MAIN_TITLE, pMe->p_MainTitle, RES_STR_MAX_LEN * sizeof( AECHAR));
293 //将标题文字输出
294 DrawTitle(pMe);
295
296 //从数据库读取中间菜单项并添加
297 IMENUCTL_AddItem( pMe->p_MainMenuCtl, MENUCTLTEST_RES_FILE, IDS_MAIN_MENU_ONE, IDS_MAIN_MENU_ONE, NULL, 0);
298 IMENUCTL_AddItem( pMe->p_MainMenuCtl, MENUCTLTEST_RES_FILE, IDS_MAIN_MENU_TWO, IDS_MAIN_MENU_TWO, NULL, 0);
299 IMENUCTL_AddItem( pMe->p_MainMenuCtl, MENUCTLTEST_RES_FILE, IDS_MAIN_MENU_THREE, IDS_MAIN_MENU_THREE, NULL, 0);
300 //将中间菜单项在页面中间显示出来
301 IMENUCTL_SetActive(pMe->p_MainMenuCtl, TRUE);
302 IMENUCTL_Redraw(pMe->p_MainMenuCtl);
303 //从数据库读取底部菜单项并添加
304 IMENUCTL_AddItem(pMe->p_SoftKeyCtl,MENUCTLTEST_RES_FILE, IDS_SOFT_OK, IDS_SOFT_OK, NULL, 0);
305 IMENUCTL_AddItem(pMe->p_SoftKeyCtl,MENUCTLTEST_RES_FILE, IDS_SOFT_EXIT, IDS_SOFT_EXIT, NULL, 0);
306 //将底部菜单项在页面底部显示出来
307 IMENUCTL_Redraw(pMe->p_SoftKeyCtl);
308 IDISPLAY_Update(pMe->a.m_pIDisplay);
309 }
310
311 static void DrawTitle(menuctltest* pMe)
312 {
313 AEERect rect;
314 int x,y;
315 //设置显示标题文字的矩形
316 SETAEERECT( &rect, 0, 0, pMe->DeviceInfo.cxScreen, MAIN_TITLE_HEIGHT);
317 IDISPLAY_FillRect(pMe->a.m_pIDisplay, &rect, TITLE_BACK_COLOR);
318 //设置文字显示的左上角坐标
319 x = (pMe->DeviceInfo.cxScreen - IDISPLAY_MeasureText( pMe->a.m_pIDisplay, AEE_FONT_BOLD, pMe->p_MainTitle)) / 2;
320 y = (MAIN_TITLE_HEIGHT - pMe->r_BlodFontHeight) / 2;
321 //将头部标题文字显示出来
322 IDISPLAY_DrawText( pMe->a.m_pIDisplay, AEE_FONT_BOLD, pMe->p_MainTitle, -1, x, y, NULL, IDF_TEXT_INVERTED | IDF_TEXT_TRANSPARENT);
323 }
本程序主要是菜单的显示，对于菜单的操作，下次再发吧！
