使用XML文件定义菜单
- Android提供了两种创建菜单的方式,一种是在Java代码中创建,一种使用XML资源文件定义。上面的实例都是在Java代码中创建菜单,在Java代码中创建菜单存在如下不足。
- 在Java代码中定义菜单、菜单项,必然导致代码臃肿。
- 需要程序员采用硬编码的方式为每个菜单项分配ID、为每个菜单组分配ID,这种方式导致应用可扩展性、可维护性降低。
一般推荐使用XML资源文件来定义菜单,这种方式可以提高更好的解耦。
菜单资源文件通常应该放在/res/menu目录下,菜单资源的根元素通常是<menu.../>元素,<menu.../>元素无须指定任何属性。<menu.../>元素内可包含如下子元素。
- <item.../>元素:定义菜单项。
- <group.../>子元素:将多个<item.../>定义的菜单包装成一个菜单组。<group.../>子元素用于控制整组菜单的行为,该元素可以指定如下常用属性。
- checkableBehavior:指定该组菜单的选择行为。可指定为none(不可选)、all(多选)和single(单选)三个值。
- menuCategory:对菜单进行分类,指定菜单的优先级。有效值为container、system、secondary和alternative。
- visible:指定改组菜单是否可见。
- enable:指定该组菜单是否可用。
<item.../>元素用于指定一份菜单项,<item.../>元素又可包含<menu.../>元素,位于<item.../>元素内部的<menu.../>就代表子菜单。
<item.../>元素可以指定如下常用属性。
- android:id:为菜单项指定一个唯一标识。
- android:title:指定菜单项的标题。
- android:icon:指定菜单项的图标。
- android:alphabeticShortcut:为菜单项指定字符快捷键。
- android:numericShortcut:为菜单项指定数字快捷键。
- android:checkable:设置该菜单项是否可选。
- android:checked:设置该菜单项是否已选中。
- android:visible:设置该菜单项是否可见。
- android:enable:设置该菜单项是否可用。
一旦在程序中定义了菜单资源后,接下来还是重写onCreateOptionsMenu(用于创建选项菜单)、onCreateContextMenu(用于创建上下文菜单)方法,在这些方法中调用MenuInflater对象的inflate方法装载指定资源对应的菜单即可。
接下来将会开发一个使用XML资源定义菜单的实例,本实例将会把前面开发的菜单示例程序改为使用XML资源定义菜单。
实例:使用XML资源定义菜单
本实例包含两种菜单:选项菜单和上下文菜单,其中国选项菜单对应的XML资源文件如下。
<?xml version="1.0" encoding="utf-8"?> <menu xmlns:android="http://schemas.android.com/apk/res/android" > <item android:title="@string/font_size" android:showAsAction="always|withText" android:icon="@drawable/font" > <menu> <!-- 定义一组单选菜单项 --> <group android:checkableBehavior="single"> <!-- 定义多个菜单项 --> <item android:id="@+id/font_10" android:title="@string/font_10"/> <item android:id="@+id/font_12" android:title="@string/font_12"/> <item android:id="@+id/font_14" android:title="@string/font_14"/> <item android:id="@+id/font_16" android:title="@string/font_16"/> <item android:id="@+id/font_18" android:title="@string/font_18"/> </group> </menu> </item> <!-- 定义一个普通菜单项 --> <item android:id="@+id/plain_item" android:showAsAction="always|withText" android:title="@string/plain_item"></item> <item android:title="@string/font_color" android:showAsAction="always" android:icon="@drawable/color"> <menu> <!-- 定义一组普通菜单项 --> <group> <!-- 定义三个菜单项 --> <item android:id="@+id/red_font" android:title="@string/red_title"/> <item android:id="@+id/green_font" android:title="@string/green_title"> </item> <item android:id="@+id/blue_font" android:title="@string/blue_title"></item> </group> </menu> </item> </menu>
上面的菜单资源文件的<menu.../>元素里包含三个<item.../>子元素,这表明该菜单里包含三个菜单项。其中第一个、第三个都包含子菜单。
接下来再为该应用定义上下文菜单的资源文件,代码如下。
<?xml version="1.0" encoding="utf-8"?> <menu xmlns:android="http://schemas.android.com/apk/res/android" > <!-- 定义一组单选菜单项目 --> <group android:checkableBehavior="single"> <!-- 定义三个菜单项 --> <item android:id="@+id/red" android:title="@string/red_title" android:alphabeticShortcut="r"/> <item android:id="@+id/green" android:title="@string/green_title" android:alphabeticShortcut="g"/> <item android:id="@+id/blue" android:title="@string/blue_title" android:alphabeticShortcut="b"/> </group> </menu>
定义了上面两份菜单资源之后,接下来即可在Activity的onCreateOptionsMenu、onCreateContextMenu方法中加载这两份菜单资源。下面是该程序中加载并显示两份菜单的Java代码。
package org.crazyit.helloworld; import android.os.Bundle; import android.app.Activity; import android.graphics.Color; import android.view.ContextMenu; import android.view.ContextMenu.ContextMenuInfo; import android.view.Menu; import android.view.MenuInflater; import android.view.MenuItem; import android.view.View; import android.widget.TextView; import android.widget.Toast; public class MenuResTest extends Activity { private TextView txt; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.menu_res_test); txt=(TextView)findViewById(R.id.txt); //为文本框注册上下文菜单 registerForContextMenu(txt); } @Override public boolean onCreateOptionsMenu(Menu menu) { MenuInflater inflator=new MenuInflater(this); //装填R.menu.my_menu对应的菜单,并添加到menu中 inflator.inflate(R.menu.my_menu, menu); // Inflate the menu; this adds items to the action bar if it is present. //getMenuInflater().inflate(R.menu.menu_res_test, menu); return super.onCreateOptionsMenu(menu); } @Override public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) { MenuInflater inflator=new MenuInflater(this); //装填R.menu.context对应的菜单,并添加到menu中 inflator.inflate(R.menu.context, menu); menu.setHeaderIcon(R.drawable.tools); menu.setHeaderTitle("选择背景色"); // TODO Auto-generated method stub //super.onCreateContextMenu(menu, v, menuInfo); } //上下文菜单中,菜单项被单击时触发该方法 @Override public boolean onContextItemSelected(MenuItem mi) { //勾选菜单项 mi.setCheckable(true); //① switch(mi.getItemId()) { case R.id.red: mi.setCheckable(true); txt.setBackgroundColor(Color.RED); break; case R.id.green: mi.setCheckable(true); txt.setBackgroundColor(Color.GREEN); break; case R.id.blue: mi.setCheckable(true); txt.setBackgroundColor(Color.BLUE); break; } return true; // TODO Auto-generated method stub //return super.onContextItemSelected(item); } //菜单项被单击后的回调方法 @Override public boolean onOptionsItemSelected(MenuItem mi) { if(mi.isCheckable()) { //勾选该菜单项 mi.setCheckable(true);//② } //判断单击的是哪个菜单项,并有针对性地作出响应 switch(mi.getItemId()) { case R.id.font_10: txt.setTextSize(10*2); break; case R.id.font_12: txt.setTextSize(12*2); break; case R.id.font_14: txt.setTextSize(14*2); break; case R.id.font_16: txt.setTextSize(16*2); break; case R.id.font_18: txt.setTextSize(18*2); break; case R.id.red_font: txt.setTextColor(Color.RED); mi.setCheckable(true); break; case R.id.green_font: txt.setTextColor(Color.GREEN); mi.setCheckable(true); break; case R.id.blue_font: txt.setTextColor(Color.BLUE); mi.setCheckable(true); break; case R.id.plain_item: Toast toast=Toast.makeText(MenuResTest.this, "您单击了普通菜单项",Toast.LENGTH_SHORT); toast.show(); break; } // TODO Auto-generated method stub //return super.onOptionsItemSelected(mi); return true; } }
上面的程序中两行粗体字代码就是加载选项菜单资源、上下文菜单资源的关键代码。
从上面的程序可以看出,如果使用XML资源文件定义菜单,就像使用布局文件来定义应用程序一样,Android应用的Java代码就会简单很多,因此可维护性更好。、
归纳起来,使用XML资源定义菜单有如下两个好处。
- XML资源文件不仅负责定义应用界面,也负责定义菜单,这样可把所有界面相关的内容交给XML文件管理,而Java代码的功能更集中。
- 后期更新、维护应用时,如果需要更新、维护菜单,打开、编辑XML文件即可,避免对Java文件的修改。
运行该程序的界面如下: