使用XML文件定义菜单

时间:2023-03-09 01:28:22
使用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文件的修改。

运行该程序的界面如下:

使用XML文件定义菜单