这个属性可接受的值有:
1、always:这个值会使菜单项一直显示在Action Bar上。
2、ifRoom:如果有足够的空间,这个值会使菜单项显示在Action Bar上。
3、never:这个值使菜单项永远都不出现在Action Bar上, 但是该菜单项会出现在平常的菜单中
4、withText:这个值使菜单项和它的图标,菜单文本一起显示。
Adding an Action Provider
1. 设置菜单,加上属性
<?xml version="1.0" encoding="utf-8"?> <menu xmlns:android="http://schemas.android.com/apk/res/android"> <item android:id="@+id/menu_share" android:title="@string/share" android:showAsAction="ifRoom" android:actionProviderClass="android.widget.ShareActionProvider" /> ... </menu>
2. 设置默认的事件
private ShareActionProvider mShareActionProvider;
@Override
public boolean onCreateOptionsMenu(Menu menu){
mShareActionProvider = (ShareActionProvider) menu.findItem(R.id.menu_share).getActionProvider();
// Set the default share intent
Intent shareIntent = new Intent();
shareIntent.setAction(Intent.ACTION_SEND);
shareIntent.putExtra(Intent.EXTRA_TEXT, "This is my text to send.");
shareIntent.setType("text/plain");
mShareActionProvider.setShareIntent(shareIntent);
return true;
}
Action Bar是什么?
很长一段时间内,开发人员一直在为他们的Android应用程序设计功能标题栏,Android 3.0正式引入了Action Bar部件,规范了应用程序导航设计,一些新的Android设备,如平板电脑也抛弃了传统的导航功能,使用软件按钮取代了物理主屏、菜单、后退和搜索按钮。
Action Bar的概念非常简单,如果你的应用程序有一个“选项”菜单,当用户点击“菜单”按钮时,出现一个活动项目菜单,你的应用程序可以利用Android 3.0中的Action Bar功能,它修改了应用程序标题栏,以一种易于使用的方式显示那些先前在“选项”菜单中的活动,如图1所示。
图 1 蜂巢设备上的Action Bar
Action Bar有哪些行为?
最棘手的是运行蜂巢及更高版本的设备显示不同Action Bar功能时,取决于应用程序的目标SDK是设置为蜂巢还是传统的API级别。
我们来看一个简单的例子,假设我们的应用程序包含四个屏幕:一个主Activity和三个“清洁的”Activity(打扫、擦洗和吸尘),我们向主Activity添加一个选项菜单,以便让用户跳转到另三个Activity,如图2所示。
图 2 带有一个选项菜单和四个屏幕的简单应用程序
该应用程序两个基本的组件是选项菜单资源文件和主Activity类,其它Activity类只是简单地显示一个ImageView和一个TextView控件,选项菜单资源文件简单定义了选项菜单项,其内容如下:
- <?xml version="1.0" encoding="utf-8"?>
- <menu
- xmlns:android=">http://schemas.android.com/apk/res/android">
- <item
- android:id="@+id/sweep"
- android:icon="@drawable/ic_menu_sweep"
- android:title="@string/sweep"
- android:onClick="onOptionSweep" />
- <item
- android:id="@+id/scrub"
- android:icon="@drawable/ic_menu_scrub"
- android:title="@string/scrub"
- android:onClick="onOptionScrub" />
- <item
- android:id="@+id/vacuum"
- android:icon="@drawable/ic_menu_vac"
- android:title="@string/vacuum"
- android:onClick="onOptionVacuum" />
- </menu>
主Activity类将这个菜单资源作为一个选项菜单载入,并定义了每个选项菜单项的onClick处理程序,其内容如下:
- package com.mamlambo.actonthis;
- import android.app.Activity;
- import android.content.Intent;
- import android.os.Bundle;
- import android.view.Menu;
- import android.view.MenuInflater;
- import android.view.MenuItem;
- public class ActOnThisActivity extends Activity {
- /** Called when the activity is first created. */
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- }
- @Override
- public boolean onCreateOptionsMenu(Menu menu) {
- MenuInflater inflater = getMenuInflater();
- inflater.inflate(R.menu.cleaningoptions, menu);
- return true;
- }
- public void onOptionSweep(MenuItem i)
- {
- startActivity(new Intent(this, SweepActivity.class));
- }
- public void onOptionScrub(MenuItem i)
- {
- startActivity(new Intent(this, ScrubActivity.class));
- }
- public void onOptionVacuum(MenuItem i)
- {
- startActivity(new Intent(this, VacuumActivity.class));
- }
- }
到现在为止我们没有做任何事情,因此我们在技术上并不需要将应用程序的Android清单文件设置为高目标API级别,我们这里将其设置为API级别9。
- <uses-sdk android:minSdkVersion="9" />
当我们在蜂巢设备上运行这个“传统的”应用程序时,系统栏会显示一个像网格的图标(第四个),它和传统Android手机上的“菜单”按钮所起的作用是等同的,只不过它变成一个软件按钮了,点击它将会显示选项菜单,就好像是在一部老式智能手机上一样,如图3所示,屏幕顶部的标题栏仅仅显示了应用程序的标题。
图 3 在蜂巢设备上的传统应用程序行为
如果我们修改应用程序Android清单文件的目标API级别,将其设为API级别11(蜂巢),应用程序将自动应用Action Bar机制。
- <uses-sdk android:minSdkVersion="11" />
默认情况下,标题栏显示了应用程序图标,名称和所谓的溢出菜单图标,点击这个图标会弹出一个文本菜单,列出选项菜单项,如图4所示。
图 4 蜂巢设备上的蜂巢应用程序行为
自定义你的Action Bar
当你的应用程序目标设为蜂巢平台时,你可以利用Action Bar部件提供的全部功能,将你的选项菜单项放在Action Bar的右上角,对用户来说使用更方便,控制该行为的主菜单项属性是android:showAsAction。
这个属性可接受的值有:
1、always:这个值会使菜单项一直显示在Action Bar上。
2、ifRoom:如果有足够的空间,这个值会使菜单项显示在Action Bar上。
3、never:这个值使菜单项永远都不出现在Action Bar上。
4、withText:这个值使菜单项和它的图标,菜单文本一起显示。
我们修改选项菜单资源文件来看看这个属性的不同使用效果,首先,如果你还记得图1的内容,不记得就返回到前面重新观察一下,你就会发现,Action Bar中显示了每个菜单项的图标和它们的名称,换句话说就是,每个菜单项目有以下属性:
- android:showAsAction="ifRoom|withText"
另一个合理的设置是显示Action Bar上的每个菜单项,只要有空间,但没有杂乱的文字,换句话说就是,每个菜单项有以下属性:
- android:showAsAction="ifRoom"
图5显示了这个变化在典型蜂巢设备上的效果。
图 5 当空间足够时,在Action Bar上显示菜单项,包括文本
最后,如果我们不想让Vacuum菜单项显示在Action Bar上,其属性值就应该是:
- android:showAsAction="never"
这样在Action Bar上将只会显示两个菜单项:Sweep和Scrub。在右上角,你会再次看到溢出菜单,点击它就会看到被设为“never”的菜单项,如Vacuum,以及其它不适合放在Action Bar上的菜单项,如图6所示。
图 6 在Action Bar上显示部分菜单项,其它菜单项永远不显示(显示在溢出菜单中)
- <?xml version="1.0" encoding="utf-8"?>
- <menu
- xmlns:android="http://schemas.android.com/apk/res/android">
- <item
- android:id="@+id/sweep"
- android:icon="@drawable/ic_menu_sweep"
- android:title="@string/sweep"
- android:onClick="onOptionSweep" />
- <item
- android:id="@+id/scrub"
- android:icon="@drawable/ic_menu_scrub"
- android:title="@string/scrub"
- android:onClick="onOptionScrub" />
- <item
- android:id="@+id/vacuum"
- android:icon="@drawable/ic_menu_vac"
- android:title="@string/vacuum"
- android:onClick="onOptionVacuum" />
- </menu>
处理Action Bar上的应用程序图标点击行为
Action Bar的另一个功能是用户可以点击左上角的应用程序图标,虽然默认情况下点击行为没有任何反应,但如果增加一个自定义“主屏幕”功能,或关联到你的启动屏幕,那样操作起来更有趣。
假设你想更新ScrubActivity类中的默认Action Bar,以便点击应用程序图标时用户可以返回到主Activity(同时清空Activity stack)。
实现起来也很简单,你只需要为ScrubActivity类实现onOptionsItemSelected()方法,并处理特定的菜单项标识符android.R.id.home即可,例如:
- @Override
- public boolean onOptionsItemSelected(MenuItem item)
- {
- switch (item.getItemId())
- {
- case android.R.id.home:
- Intent intent = new Intent(this, ActOnThisActivity.class);
- intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
- startActivity(intent);
- return true;
- default:
- return super.onOptionsItemSelected(item);
- }
- }
就这么简单,你也可以在应用程序图标的左边显示一个箭头,在你Activity的onCreate()方法中联合使用setDisplayHomeAsUpEnabled()方法,可以返回到指定的屏幕。
- ActionBar bar = getActionBar();
- bar.setDisplayHomeAsUpEnabled(true);
如图7所示,我们在Sweep屏幕上启用了这个功能,在Action Bar上增加了一个箭头小图标。
图 7 带有可点击的主屏幕按钮和一个返回箭头的Action Bar
使用不需要Action Bar的屏幕
当你将应用程序目标设为API 11或更高时,你的所有屏幕默认都将拥有Action Bar,如果你不想用这个新部件,有几种方法可以移除它,最简单的方法可能是通过编程手段直接在Activity类中关闭它,例如,我们可以用下面两行代码关闭Vacuum屏幕上的Action Bar,只需要将这两行代码添加到Activity类的onCreate()方法中即可。
- ActionBar bar = getActionBar();
- bar.hide();
这两行代码将移除屏幕顶部的整个Action Bar,应用程序名称也不会显示了,你也可以隐藏Action Bar,在布局文件中创建一个特殊的自定义主题即可,详细情况请阅读Android SDK文档。
Action Bar的高级功能
本文只是对Action Bar做了简单的介绍,可以说只触及了它的表面,Action Bar是支持样式的,包括修改背景图像和其它自定义属性,它们也支持多个其它成熟的视图类型和部件,不仅仅是那些在选项菜单中的菜单项,如标签和下来列表,你甚至可以增加其它类型的视图控件,创建Action Bar功能区域,详细情况请阅读Android SDK文档。
小结
如果你的应用程序已经使用了选项菜单,当你把目标设为蜂巢设备时,你可以利用Action Bar的所有功能,就像向你的菜单布局文件增加一些新属性一样简单。每个屏幕的Action Bar都是可定制的,作为开发人员,你可以控制显示哪个项目,以及如何显示,当你想留更多的屏幕显示游戏画面等内容时,你甚至可以移除整个Action Bar。