ActionBar是Android3.0(API levle 11)添加的新特性,在Android3.0及以上平台中只需要以下代码便实现:
import android.app.ActionBar;
在Android3.0以下平台需要导入支持库(Android导入支持库教程):
import android.support.v7.app.ActionBar;
import android.support.v7.app.ActionBarActivity
并且,在Android3.0以下平台,你的Activity必须扩展ActionBarActivity,你的application或者activity必须使用Theme.AppCompat主题或扩展自Theme.AppCompat的主题:
public class MainActivity extends ActionBarActivity{/**/}
至此,你的Activity已经拥有一个默认样式的的ActionBar了。
在Android3.0及以上平台中只需要以下代码获取当前Activity的ActionBar的实例:
ActionBar actionBar = getActionBar();
在Android3.0以下平台使用以下代码获取ActionBar实例:
ActionBar actionBar = getSupportActionBar();
获取到ActionBar引用后就可对ActionBar进行显示/隐藏了。
actionBar.show();//显示ActionBar
actionBar.hide();//隐藏ActionBar
所谓导航到父Activity,就是点击ActionBar左端的Icon或者logo时可以回到当前Activity的上一个Activity,只需一行代码即可:
actionBar.setDisplayHomeAsUpEnabled(true);
可以在manifest文件中指定当前Activity的父Activity:
从Android4.1(API level 16)开始,只需要在activity元素中声明parentActivityName即可;为了支持低版本平台,需要为activity添加meta-data子元素:
Action Button的资源文件存放于res/menu/下,如main.xml
该文件声明了6个item,其中showAsAction属性,ifRoom表示如果ActionBar有足够的空间则将该item显示在ActionBar,否则显示到Menu菜单中;never表示永远显示在Menu菜单中,无论空间是否足够。orderInCategory属性值小的item优先显示到ActionBar。竖屏和横屏显示效果如下:
在需要添加Action Button的Activity中重写onCreateOptionsMenu方法将这6个item添加到ActionBar:
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// 填充menu到ActionBar
getMenuInflater().inflate(R.menu.main, menu);
//可以在次为menu items添加监听
return true;
}
重写onOptionsItemSelected方法为每个menu添加点击事件响应:
@Override
public boolean onOptionsItemSelected(MenuItem item) {
// Handle action bar item clicks here. The action bar will
// automatically handle clicks on the Home/Up button, so long
// as you specify a parent activity in AndroidManifest.xml.
int id = item.getItemId();
switch (id) {
case R.id.action_settings:
showToastShort("settings");
break;
case R.id.action_search:
showToastShort("search");
break;
case R.id.action_new:
showToastShort("new");
break;
case R.id.action_edit:
showToastShort("edit");
break;
case R.id.action_refresh:
showToastShort("refresh");
break;
case R.id.action_remove:
showToastShort("remove");
break;
default:
break;
}
return super.onOptionsItemSelected(item);
}
在较窄的屏幕上使ActionBar与Action Button分离,Action Button显示到屏幕的下方,添加uiOptions属性到application或者activity元素,api14及以下需要在activity内添加子元素meta-data,如下: