Android ActionBar的基础使用
这个示例演示了ActionBar的基础使用，包括如何在menu.xml中定义menu items并将其填充到ActionBar的options menu中，以及如何在代码中将menu item添加到给定的options menu中。
介绍##
Android3.0引入了ActionBar，ActionBar可以标识用户所在应用的位置，提供用户在应用的各个Activity间进行切换、导航。示例在运行在Android4.0以上，不支持4.0以下版本。
屏幕截图
basic_actionBar
basic_actionBar2
代码实现
layout/activity_main.xml
<!--
android:textAppearance="?android:attr/textAppearanceMedium"
基本的文字颜色，字体，大小和样式
android:paddingRight="@dimen/margin_small"
文本距离TextView的左边距，这里引用了dimen中定义的margin_small值8dp
android:paddingLeft="@dimen/margin_small"
文本距离TextView的右边距，这里引用了dimen中定义的margin_small值8dp
android:text="@string/intro_message"
TextView的文本，这里引用了strings.xml中定义的intro_message
android:layout_width="match_parent"
TextView的宽度
android:layout_height="match_parent"
TextView的高度
android:gravity="center_vertical"
设置文本在TextView中的显示方式为垂直居中
-->
<TextView
android:paddingRight="@dimen/margin_small"
android:paddingLeft="@dimen/margin_small"
android:text="@string/intro_message"
android:textAppearance="?android:attr/textAppearanceMedium"
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center_vertical" />
values/dimens.xml
<resources>
<!-- 定义标准的margin值 -->
<dimen name="margin_tiny">4dp</dimen>
<dimen name="margin_small">8dp</dimen>
<dimen name="margin_medium">16dp</dimen>
<dimen name="margin_large">32dp</dimen>
<dimen name="margin_hurge">64dp</dimen>
<!-- Default screen margins, per the Android Design guidelines. -->
<dimen name="activity_horizontal_margin">16dp</dimen>
<dimen name="activity_vertical_margin">16dp</dimen>
</resources>
values/ids.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<!-- 为menu_location生成一个唯一的id -->
<item name="menu_location" type="id"></item>
</resources>
values/strings.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="app_name">BasicActionBar</string>
<string name="hello_world">Hello world!</string>
<string name="menu_settings">设置</string>
<!--
CDATA区中的文本将作为普通文本，即使有XML标签。
-->
<string name="intro_message">
<![CDATA[
这个示例演示Action Bar的基础使用，包括如何在menu.xml中添加menuItem和
如何在onCreateOptionsMenu(Menu menu)方法中用Java代码添加menuItem。
]]>
</string>
<string name="menu_refresh">刷新</string>
<string name="menu_location">位置</string>
</resources>
menu/main.xml
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
tools:context="com.ddzj.basicactionbar.MainActivity" >
<!--
刷新Item
android:id="@+id/action_refresh"
为该item添加id
android:showAsAction="ifRoom"
设置如果ActionBar上有空间的话就在ActionBar上显示，否则在overflow中显示
android:title="@string/menu_refresh"
设置该item的标题属性，这里引用了strings.xml中定义的menu_refresh
android:icon="@drawable/ic_action_refresh"
设置该item的icon图标，这里引用了drawable下的ic_action_refresh
-->
<item
android:id="@+id/action_refresh"
android:showAsAction="ifRoom"
android:title="@string/menu_refresh"
android:icon="@drawable/ic_action_refresh"
/>
<!-- 我们将在代码中添加定位item -->
<!--
设置item：
android:id="@+id/action_settings"
为该item添加id
android:title="@string/menu_settings"
该item的标题
android:icon="@drawable/ic_action_settings"
该item的icon
android:showAsAction="never"
总是在overflow中显示
-->
<item
android:id="@+id/action_settings"
android:title="@string/menu_settings"
android:icon="@drawable/ic_action_settings"
android:showAsAction="never"
/>
</menu>
MainActivity.java
package com.ddzj.basicactionbar;
import android.app.Activity;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
/*
* 初始化Activity的标准选择菜单中的内容，在这个方法中将menu items添加到menu中。 这个方法只在选择菜单（options
* menu）第一次被显示出来的时候调用一次。要在该菜单每次显示的时候更新它，请参见onPrepareOptionsMenu方法。
*
* 参数：
* menu:将menu items放入其中的options menu.
*
* 返回: 要让菜单显示，你必须返回true，否则不显示
*/
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// 将在menu.xml中定义好的menu items填充到menu中。inflate--填充
getMenuInflater().inflate(R.menu.main, menu);
/*
* 使用代码手动添加定位item
*
* add(int groupId, int itemId, int order, CharSequence title)
* 这个方法将一个menu item添加到给定menu中。
*
* 参数:
* groupId:该item所属的group的group标识符。如果没有所属，则写Menu.NONE
* itemId: 该item的Id.如果不需要一个唯一的ID，则写Menu.NONE,因为我们要处理该item的点击事件，
* 因此需要一个唯一的id来标示，我们在values/ids.xml中为该item定义一个id.
* order: 如果不关心顺序，则写Menu.NONE. 参见MenuItem.getOrder()
* title: 该item显示的文字
*/
MenuItem locationItem = menu.add(Menu.NONE, R.id.menu_location, Menu.NONE, R.string.menu_location);
locationItem.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
locationItem.setIcon(R.drawable.ic_action_location);
return true;
}
/*
* 当你的options menu中的menu item被点击时，调用此函数。hook：回调函数、钩子
* 参数:
* item：被点击的menu item
*/
@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
case R.id.action_refresh:
// 处理刷新的代码
return true;
case R.id.menu_location:
// 处理定位的代码
return true;
case R.id.action_settings:
// 处理设置的代码
return true;
}
// 总是调用该方法来做默认的处理
return super.onOptionsItemSelected(item);
}
}
图片资源##
ic_action_location.png
ic_action_refresh.png
ic_action_settings.png
ic_launcher.png
