注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好。
原文链接:http://developer.android.com/training/basics/actionbar/adding-buttons.html
Action Bar允许你为和应用当前Context相关的最重要的action事件添加按钮。那些在Action Bar中直接显示出来的图标或文字就是所谓的Action Buttons。在Action Bar中无法完整显示的或者不是足够重要的操作按钮,都被隐藏在了更多操作这一按钮中,如下图所示:
图1. 具有一个“搜索”的操作按钮和一个“更多操作”(action overflow)按钮(其中包含了更多的操作)的Action Bar
一). 在XML中列举出操作
所有的操作按钮还有其他在更多操按钮中的所有项目,都在一个菜单资源(menu resource)的XML文件中定义。为了把操作添加到Action Bar中,在项目的“res/menu/”目录下创建一个新的XML文件。
为每一个你希望添加到Action Bar中的项目添加一个<item>标签。例如:
<menu xmlns:android="http://schemas.android.com/apk/res/android" >
<!-- Search, should appear as action button -->
<item android:id="@+id/action_search"
android:icon="@drawable/ic_action_search"
android:title="@string/action_search"
android:showAsAction="ifRoom" />
<!-- Settings, should always be in the overflow -->
<item android:id="@+id/action_settings"
android:title="@string/action_settings"
android:showAsAction="never" />
</menu>
上述用于声明的代码表明:如果Action Bar的空间充足,那么搜索的操作按钮将会显示,但是设置这一操作的按钮将永远在“更多操作”当中。(所有的操作都会默认的在“更多操作”中显示,但显示地为每个操作声明设计的意图是一个好的习惯)。
下载Action Bar图标:
为了和Android图标风格(iconography)达到完美的视觉效果,建议你使用Action Bar Icon Pack提供的图标。
这个“icon”属性字段需要一个图像的资源ID。在“@drawable/”之后跟随着的名字必须是一个你在项目工程的“res/drawable/”存储好的一幅位图文件。例如:“@drawable/ic_action_search”代表了“ic_action_search.png”。类似的,“title”属性字段使用的是在项目工程中“res/values/”目录下通过XML文件定义好的字符资源,这些都在Building a Simple User Interface有讨论过。(对应博客链接:http://www.cnblogs.com/jdneo/p/3439108.html)
Note:
当为你的应用创建图标和其他位图时,一个很重要的事情是你最好为各种分辨率屏幕的设备准备多个版本。这些在课程:Supporting Different Screens有更多的讨论。
如果你的应用使用了Support Library来兼容低至Android 2.1版本的系统,“showAsAction”这一属性字段并不属于“android:”命名空间。不过这个属性字段由Support Library来提供,所以你必须定义你自己的XML命名空间,然后使用这个命名空间作为字段的前缀。(一个自定义的XML命名空间最好以你的应用名为基础,当然它可以是你希望的任何名字,并且它的作用域只在你声明它的文件这一范围内)例如:
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:yourapp="http://schemas.android.com/apk/res-auto" >
<!-- Search, should appear as action button -->
<item android:id="@+id/action_search"
android:icon="@drawable/ic_action_search"
android:title="@string/action_search"
yourapp:showAsAction="ifRoom" />
...
</menu>
二). 为Action Bar添加操作
为了将这个菜单项添加进Action Bar,我们需要在你的activity中实现onCreateOptionsMenu()这一回调函数,以此来将菜单资源填充进菜单(Menu)对象中,例如:
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu items for use in the action bar
MenuInflater inflater = getMenuInflater();
inflater.inflate(R.menu.main_activity_actions, menu);
return super.onCreateOptionsMenu(menu);
}
三). 操作按钮的响应
当用户按下了其中一个操作按钮,或者“更多操作”中的操作按钮,系统会调用你的activity中的回调函数onOptionsItemSelected(),在你这个方法的实现中,对参数MenuItem调用getItemId()方法来确定是哪个按钮被按下了。返回的资源ID(ResId)是和你在<item>标签中“android:id”这一属性字段所声明的ID是对应的。
@Override
public boolean onOptionsItemSelected(MenuItem item) {
// Handle presses on the action bar items
switch (item.getItemId()) {
case R.id.action_search:
openSearch();
return true;
case R.id.action_settings:
openSettings();
return true;
default:
return super.onOptionsItemSelected(item);
}
}
四). 为上一级Activity添加返回操作
图2. Gmail的返回按钮
所有你的应用中非主入口的画面(即指的是除了你的应用的“home”画面外的所有其他画面)必须为用户提供一个导航至应用逻辑层次结构中的父画面,这可以通过让用户按下“Action Bar”中的“返回(Up)”按钮来实现。
当在Android 4.1(API Level 16)或更高的系统版本中运行时,或者使用Support Library提供的ActionBarActivity时,实现返回的导航功能,只需要你在清单文件中声明父Activity,并且激活action bar的返回按钮。
例如,你可以在清单文件中这样写:
<application ... >
...
<!-- The main/home activity (it has no parent activity) -->
<activity
android:name="com.example.myfirstapp.MainActivity" ...>
...
</activity>
<!-- A child of the main activity -->
<activity
android:name="com.example.myfirstapp.DisplayMessageActivity"
android:label="@string/title_activity_display_message"
android:parentActivityName="com.example.myfirstapp.MainActivity" >
<!-- Parent activity meta-data to support 4.0 and lower -->
<meta-data
android:name="android.support.PARENT_ACTIVITY"
android:value="com.example.myfirstapp.MainActivity" />
</activity>
</application>
之后通过调用setDisplayHomeAsUpEnabled()来激活返回按钮:
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_displaymessage); getSupportActionBar().setDisplayHomeAsUpEnabled(true);
// If your minSdkVersion is 11 or higher, instead use:
// getActionBar().setDisplayHomeAsUpEnabled(true);
}
因为现在系统知道“MainActivity”是“DisplayMessageActivity”的父Activity,当用户按下返回按钮,系统将会自动地导航至父Activity,你不需要去对返回按钮做任何事件处理。
阅读Providing Up Navigation,获取更多信息。