Symbian中自定义CBA PANE MENU

ZT:http://blog.sina.com.cn/s/blog_448367c90100a9fm.html

 

菜单(Menu)

    菜单是当用户按下选项(Options)键(CBA按键)时显示的命令列表窗口。菜单由多个菜单项(菜单命令)组成，每个菜单项表示为一个文本标签。菜单可以通过在资源文件中指定菜单条(menu bar)和菜单面板(menu pane)资源创建。菜单条可以包含一个或多个由菜单项组成的菜单面板。一旦用户选择了一条菜单项，应用框架将调用应用程序命令处理器响应相应的选择。

    菜单可以添加到主应用程序屏幕、应用程序视图、对话框和其他一些控件上。一旦显示了菜单，软件(CBA)即会更改为左键选择(Select)右键取消(Cancel)。

    菜单项可以含有一个子菜单。子菜单包含与此菜单项相关的其他命令集合。每个菜单项最多只能包含一个子菜单，子菜单不能再包含子菜单。

 

1、使用菜单资源定义菜单

1.1、MENU_BAR

    菜单资源通过在MENU_BAR结构体中定义:

RESOURCE MENU_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结构体中定义:

RESOURCE MENU_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_VIEW r_my_view
{
    menubar = r_my_menu_bar; 
    cba = R_AVKON_SOFTKEYS_OPTIONS_BACK;   
} 

 

3、动态菜单

    动态菜单是指在应用程序运行过程中，根据需要更改菜单条(menu bar)或菜单项(menu item)。

3.1、更改菜单条(menu bar)

    改变应用程序所使用的菜单资源:

iEikonEnv->AppUiFactory()->MenuBar()->

                                          SetMenuTileResourceId(MENU_BAR_RESOURCE_ID);

    改变应用程序视图所使用的菜单资源:

iMyView->MenuBar()->SetMenuTitleResourceId(MENU_BAR_RESOURCE_ID); 

 

3.2、更改菜单项(menu item) 

    所有可以拥有菜单的UI组件(AppUi、View)都继承了MEikMenuObserver混合类。该类定义了虚方法DyInitMenuPaneL()，通过重写此方法可以动态更改菜单项(隐藏菜单项)。当应用程序将菜单面板(menu pane)添加到菜单后由应用程序框架调用，aResourceId为添加的菜单面板资源ID。

void CMyAppUi::DynInitMenuPaneL( TInt aResourceId, CEikMenuPane* aMenuPane ) 
{ 
    aMenuPane->SetItemDimmed(EMyAppCmdCom1, ETrue); 
    aMenuPane->SetItemDimmed(EMyAppCmdCom2, ETrue); 

}   

 

 

ZT:http://blog.sina.com.cn/s/blog_448367c90100a9fm.html