Symbian O 应用程序UI组件 — 菜单、状态面板.docxVIP

菜单(Menu)    菜单是当用户按下选项(Options)键(CBA按键)时显示的命令列表窗口。菜单由多个菜单项(菜单命令)组成，每个菜单项表示为一个文本标签。菜单可以通过在资源文件中指定菜单条(menubar)和菜单面板(menupane)资源创建。菜单条可以包含一个或多个由菜单项组成的菜单面板。一旦用户选择了一条菜单项，应用框架将调用应用程序命令处理器响应相应的选择。    菜单可以添加到主应用程序屏幕、应用程序视图、对话框和其他一些控件上。一旦显示了菜单，软件(CBA)即会更改为左键选择(Select)右键取消(Cancel)。    菜单项可以含有一个子菜单。子菜单包含与此菜单项相关的其他命令集合。每个菜单项最多只能包含一个子菜单，子菜单不能再包含子菜单。   1、使用菜单资源定义菜单 1.1、MENU_BAR     菜单资源通过在MENU_BAR结构体中定义: RESOURCEMENU_BAR r_my_menu_bar    {     titles=        {         MENU_TITLE{ txt = ; menu_pane = r_my_menu_pane1; },         MENU_TITLE{ txt = ; menu_pane = r_my_menu_pane2; }        };    }       MENU_BAR结构体中包含一个titles数组，数组的每个元素是一个MENU_TITLE结构。MENU_TITLE结构由两个字段组成:txt字段指定菜单的标题，但在S60中菜单标题并不显示，所以通常设置为空，但某些时候提供一个有意义的菜单标题可以作为提示信息。menu_pane字段引用一个MENU_PANE结构，包含了菜单项。当titles数组中包含多个元素时，菜单在显示菜单项的顺序时，将按照数组元素定义的先后顺序从上而下的显示每个元素引用的MENU_PANE结构中定义的菜单项。 1.2、MENU_PANE    菜单的菜单项通过在MENU_PANE结构体中定义: RESOURCEMENU_PANE r_my_menu_pane1    {   items =       {       MENU_ITEM { command = EMyAppCmdCom1; txt = item1; },       MENU_ITEM { command = EMyAppCmdCom2; txt = item2; }       };    }    MENU_PANE结构体中包含了一个items数组，数组的每个元素是一个MENU_ITEM结构，也就是一个菜单项。MENU_ITEM结构由以下个字段组成:command字段指定了菜单项的命令ID。命令ID是一个应用程序内唯一的枚举值，在扩展名为.hrh的头文件中定义(通常命令ID的名称格式为:E应用程序名Cmd命令名)；txt字段指定了菜单项显示的文本信息；cascade字段指定了子菜单项，需要引用一个MENU_PANE结构。   2、应用程序与菜单关联 2.1、主应用程序与菜单关联    通过设置资源文件中的EIK_APP_INFO结构中的menubar和cba字段: RESOURCE EIK_APP_INFO    {    menubar = r_my_menu_bar;    cba = R_AVKON_SOFTKEYS_OPTIONS_BACK;    }    2.2、视图与菜单关联    通过设置资源文件中的AVKON_VIEW结构中的menubar和cba字段: RESOURCE AVKON_VIEWr_my_view    {   menubar = r_my_menu_bar;    cba =R_AVKON_SOFTKEYS_OPTIONS_BACK;      }    3、动态菜单    动态菜单是指在应用程序运行过程中，根据需要更改菜单条(menubar)或菜单项(menu item)。 3.1、更改菜单条(menubar)     改变应用程序所使用的菜单资源: iEikonEnv-AppUiFactory()-MenuBar()-                                          SetMenuTileResourceId(MENU_BAR_RESOURCE_ID);     改变应用程序视图所使用的菜单资源: iMyView-MenuBar()-SetMenuTitleResourceId(MENU_BAR_RESOURCE_ID);    3.2、更改菜单项(menuitem)     所有可以拥有菜单的UI组件(AppUi、View)都继承