9IMenuCtl接口选编.ppt

IMenuCtl接口的使用 计算机系 计科教研室 办公室：C117 BREW中的菜单控件--IMenuCtl BREW 中的IMenuCtl接口用于创建一个菜单控件 菜单控件允许设备用户从项目列表中作出选择 使用“向上”、“向下”、“向左”和“向右”箭头键可以指定当前选择的菜单项 已选择的菜单项将在屏幕上突出显示 IMenuCtl接口的使用步骤 使用ISHELL_CreateInstance()创建IMenuCtl接口实例（菜单控件） 向菜单控件中添加菜单项（items） 设置菜单控件的属性 激活菜单控件，并使其能接收按键事件 在事件处理函数中，响应菜单控件的事件 释放菜单控件 1、创建菜单控件 使用ISHELL_CreateInstance()创建IMenuCtl接口实例（菜单控件） 创建IMenuCtl接口实例时，不同的ClassID代表要创建不同类型的菜单： 标准菜单控件（ AEECLSID_MENUCTL） 列表控件（AEECLSID_LISTCTL） 软键菜单控件（ AEECLSID_SOFTKEYCTL） 图标视图菜单控件（AEECLSID_ICONVIEWCTL ） 创建成功后，得到一个指向菜单控件的指针，通过该指针使用菜单控件并在使用完后释放 1、创建菜单控件—例 例：创建一个标准菜单控件： IMenuCtl *pIMenuCtl; ISHELL_CreateInstance(pMe-pIShell, AEECLSID_MENUCTL, pIMenuCtl); if (pIMenuCtl == NULL) return; 2、向菜单控件中添加菜单项 IMenuCtl接口中提供了两个函数用来添加菜单项： IMENUCTL_AddItem() 添加文本菜单项 IMENUCTL_AddItemEx() 可添加带图标的菜单项。 2、向菜单控件中添加菜单项—文本菜单项 IMENUCTL_AddItem() boolean IMENUCTL_AddItem( IMenuCtl * pIMenuCtl, const char * pszResFile, uint16 wResID, uint16 nItemID, AECHAR * pText, uint32 lData ) 函数返回结果为TRUE：菜单项添加成功 函数返回结果为FALSE：菜单项添加失败 2、向菜单控件中添加菜单项—文本菜单项 boolean IMENUCTL_AddItem(IMenuCtl * pIMenuCtl, const char * pszResFile, uint16 wResID, uint16 nItemID, AECHAR * pText, uint32 lData ) 文本菜单项上的文本，可以取自于一个AECHAR类型的字符串，也可以取自于资源文件中的字符串资源 如果取自于AECHAR类型的字符串，则由参数pText指向该字符串 如果取自于资源文件，则由参数pszResFile指向资源文件名， wResID给出字符串资源的ID值 nItemID为每一个菜单项的ID，用于区分各个菜单项 2、向菜单控件中添加菜单项—文本菜单项 在添加菜单项时，要为每一个菜单项指定一个不重复的ID值（uint16） 该ID值是区分各个菜单项的标识 IMENUCTL_AddItem函数中的参数nItemID即为所添加的菜单项的ID 习惯上，将要添加的各个菜单项的ID进行常量定义： 例： #define MY_MENU_ID_M1 10001 #define MY_MENU_ID_M2 10002 #define MY_MENU_ID_M3 10003 #define MY_MENU_ID_M4 10004 #define MY_MENU_ID_M5 10005 2、向菜单控件中添加菜单项—文本菜单项 例：菜单文本存放一个AECHAR字符串中 #define MY_MENU_ID_M1 10001 。。。 AECHAR mtItem[5] = LOPEN; IMenuCtl *pIMenuCtl; ISHELL_CreateInstance(pMe-pIShell, AEECLSID_MENUCTL, pIMenuCtl); //创建菜单控件 IMENUCTL_AddItem(pIMenuCtl,NULL,NULL,MY_MENU_ID_M1,mtItem,0); //向菜单控件中添加一个文本菜单项 2、向菜单控件中添加菜单项—文本菜单项 例：菜单文本存放在资源文件中 资源文件头文件：mymenu.brh： #define MYMENU_RES_FILE mymenu.bar #defin