Symbian中自定义CBA PANE MENU

最新推荐文章于 2010-07-07 16:32:00 发布

Mirage520

最新推荐文章于 2010-07-07 16:32:00 发布

阅读量1.8k

点赞数

分类专栏： Symbian资料文章标签： menu symbian command 框架 cmd 扩展

Symbian资料专栏收录该内容

32 篇文章

订阅专栏

本文详细介绍了S60平台上的菜单系统实现方式，包括菜单资源定义、菜单与应用程序及视图的关联方法，以及如何实现动态菜单等功能。文章通过具体的资源文件配置示例，帮助开发者更好地理解和掌握S60菜单系统的使用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

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