使用动作条首先要使用一个带有动作条的主题,其次是创建一个菜单资源并为它添加动作项,然后在需要使用动作条的活动中实现 onCreateOptionsMenu()
将菜单资源添加到动作条。
先说在不使用 v7 支持库时,也就是活动继承自 Activity
类 而不是
ActionBarActivity
类(应该已经弃用转而用 AppCompatActivity类替代,可以参照http://blog.csdn.net/qq_32736689/article/details/50753687)。
使用带有动作条的主题
如果在API 11或更高级别上运行,可以应用主题 Theme.Holo
或它的某个子类来增加动作条(可以在Android R.style参考文档中找到 Android 内置主题的完整列表:http://developer.android.com/reference/android/R.style.html)
确保活动继承自 Activity
类。
在 AndroidManifest.xml 中应用主题。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.lim.bitsandpizzas">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher" // 应用的图标
android:label="@string/app_name" // 用户友好的主题名
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme"> // 主题
<activity android:name=".MainActivity"
android:label="@string/app_name" > // 用户友好的活动名
...
</activity>
</application>
</manifest>
在样式资源文件中定义样式:
<resources>
<!-- Base application theme. -->
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"> // AS 默认提供了一个主题
// 可自行修改为 android:Theme.Holo.Light 或其他支持ActionBar 的主题
<!-- Customize your theme here. -->
</style>
</resources>
创建菜单资源并将其添加到活动
(如果 AS 没有为你创建的话)创建 app/src/main/res/menu 文件夹,所有的菜单资源都放在这个文件夹下。创建 menu_mian.xml 。
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:app="http://schemas.android.com/apk/res-auto" // 如果不使用v7支持库,这条属性可以省略
xmlns:android="http://schemas.android.com/apk/res/android">
<item android:id="@+id/action"
android:title="action"
android:orderInCategory="1"
android:showAsAction="ifRoom" />
</menu>
每个菜单资源文件都有一个根元素 <menu>。使用 <item> 元素为菜单增加动作项。
<item> 常见的属性:
andorid:id |
为动作指定一个唯一的 ID。必须有 ID 才能在活动代码中引用这个动作项。 |
---|---|
android:icon |
动作项的图标。这是一个 drawable 或 mipmap 资源 |
android:title |
动作项的文本。如果一个一个动作项有一个图标,但是动作条上没有足够的空间同时显示动作项和图标,可能不会显示这个文本。若果这个动作项出现在动作条的溢出区,就只会显示文本。 |
android:orderInCategory |
这是个整数值,可以帮助 Android 确定动作项在动作条中出现的顺序。 |
菜单 showAsAction 属性,用于指示是否希望这一项出现在动作条中。
"ifRoom" |
如果有空间将这个菜单项放在动作条中,否则,放在溢出区 |
---|---|
"withText" |
包含这个菜单项的标题文本 |
"never" |
将这一项放在溢出区,不要放在主动作条中 |
"always" |
总是把这一项放在主动作条中。如果很多项都应用这个值,他们可能会重叠 |
在要添加菜单项的 Activity 中实现 onCreateOptionsMenu()
方法在活动中填充菜单。
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu; this adds items to the action if it is present.
getMenuInflater().inflate(R.menu.menu_main, menu);
MenuItem menuItem = menu.findItem(R.id.action_share);
return super.onCreateOptionsMenu(menu);
}
用 onOptionsItemSelected()
方法响应动作项单击。
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
case R.id.action_name1:
// code to run when the action1 item is clicked
case R.id.action_name2:
// code to run when the action2 item is clicked
default:
return super.onOptionsItemSelected(item);
}
}
以上是添加动作条的基本内容。而如果你的 Activity 是扩展自 AppCompatAvtivity
类,或者说只要你在 App 中使用 v7 支持库,在 menu 资源文件中 showAsAction
属性的前缀就要写成 app,即 app:showAsAction="value"
( value
是上面showAsAction
值 ),而且 xmlns:app="http://schemas.android.com/apk/res-auto"
属性不可省略。如果使用 v7 支持库,最好让活动扩展自 AppCompatActivity
类,因为在使用 v7 支持库而让活动扩展自 Activity 类时,在使用 ShareActionProvider
时会出现错误。
下面说一下在动作项中使用 ShareActionProvider (共享动作提供者)。ShareActionProvider 允许用户与其他应用共享应用中的内容,它会定义自己的图标,我们不需要自行添加。单击图标时会提供一个可用于共享的应用列表。
让 ShareActionProvider 共享内容,需要为它传递一个 Intent 。
依旧是不使用 v7 支持库时:
在菜单资源文件中添加一个 <item> 。
<item android:id="@+id/action_share"
android:title="share"
android:orderInCategory="2"
android:actionProviderClass="android.widget.ShareActionProvider"
android:showAsAction="ifRoom" />
在活动代码中 增加一个 android.weight.ShareActionProvider
类型的私有变量 shareActionProvider
,在 onCreateOptionsMenu()
方法中增加设置 shareActionProvider 的代码:
@Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.menu_main, menu);
MenuItem menuItem = menu.findItem(R.id.action_share);
shareActionProvider = (ShareActionProvider) menuItem.getActionProvider();
setIntent("text");
return super.onCreateOptionsMenu(menu);
}
public void setIntent(String text) {
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setType("text/plain");
intent.putExtra(Intent.EXTRA_TEXT, text);
shareActionProvider.setShareIntent(intent);
}
如果使用 v7 支持库,在声明 ShareActionProvider
时,必须要用到 android.support.v7.widget.ShareActionProvider
,即菜单资源文件中的声明是
app:android.support.v7.widget.ShareActionProvider
, 同时 showAsAction
属性的前缀也必须改成 app,即 app:showAsAction
。事实上,这些 AS 都会给出错误提示而且支持快速改正。活动代码中的 ShareActionProvider
也必须改成导入 android.support.v7.widget.ShareActionProvider
,在 onCreateOptionsMenu()
方法中获取 shareActionProvider 对象的语句也应该改成 shareActionProvider = (ShareActionProvider) MenuItemCompat.getActionProvider(menuItem)
。使用 MenuItemCompat
需要导入 import android.support.v4.view.MenuItemCompat
包。
// ShareActionProvider 动作项的声明
<item android:id="@+id/action_share"
android:title="@string/action_share"
android:orderInCategory="2"
app:showAsAction="ifRoom"
app:actionProviderClass="android.support.v7.widget.ShareActionProvider" />
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflater the menu; this adds items to the action bar if it is present.
getMenuInflater().inflate(R.menu.menu_main, menu);
MenuItem menuItem = menu.findItem(R.id.action_share);
// 更新后的语句
shareActionProvider = (ShareActionProvider) MenuItemCompat.getActionProvider(menuItem);
setIntent("This is example text");
return super.onCreateOptionsMenu(menu);
}
在使用 v7 支持包里的扩展之后,Activity 也必须扩展 AppcompatActivity
类,这就是为什么前面说如果使用 v7 支持,就最好直接扩展 AppCompatActivity
而不是 Activity
。因为在具体使用中,如果使用了 v7 支持包的组件而活动却扩展 Activity
类,虽然编码时不会提示错误,但是在运行时 ShareActionProvider.setShareIntent()
方法会抛出 NullPointerException 。原因我还不知道。
支持向上导航
为活动设置父活动,并在子活动的 onCreate() 方法中启用向上导航键就可以了(为活动增加抽屉时还会用到这个导航键,这里不表)。
设置活动的父活动:在 Andriodmanifest.xml 文件中为子活动增加如下设置
<activity android:name=".ChildActivity"
android:label="ActivityName"
android:parentActivityName=".MainActivity"> // 支持 API 16 以上的应用会使用这行代码指定父活动
// 只有支持 API 16 以下的应用时才需要 <meta-data> 元素。包含这个元素也没什么坏处
<meta-data android:name="android.support.PARENT_ACTIVITY"
android:value=".MainActivity" />
</activity>
在 ChildActivity
的 onCreate()
方法中增加如下代码以启动向上导航键
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_child);
// 下面两行用于启用导航键
ActionBar actionBar = getSupportActionBar();
actionBar.setDisplayHomeAsUpEnabled(true);
}