ActionBar的用法

1、ActionBar的简介

ActionBar位于Activity的顶部,可用来显示activity的标题、Icon、Actions和一些用于交互的View。它也可被用于应用的导航。

ActionBar 是在Android 3.0(API 11)中加入到SK中的,想在低版本中使用ActionBar有两种选择:使用http://actionbarsherlock.com
或使用Support Library v7。

下面是一张使用ActionBar的界面截图:

其中,[1]是ActionBar的图标,[2]是两个action按钮,[3]是overflow按钮

2、使用ActionBar

开发API11以下的程序,首先必须在AndroidManifest.xml中指定Application或Activity的theme是Theme.Holo或其子类,否则将无法使用ActionBar。

2.1 创建Actions

Actions即ActionBar中的每个交互项,可以在代码中创建Action,也可以在XML文件中指定(位于res/menu)。在menu资源文件中定义Action的方法如下:

[java] view
plain
 copy

  1. <menu xmlns:android="http://schemas.android.com/apk/res/android" >
  2. <item
  3. android:id="@+id/action_refresh"
  4. android:orderInCategory="100"
  5. android:showAsAction="always"
  6. android:icon="@drawable/ic_action_refresh"
  7. android:title="Refresh"/>
  8. <item
  9. android:id="@+id/action_settings"
  10. android:title="Settings">
  11. </item>
  12. </menu>

showAsAction属性用来定义每个Action是如何显示的,always表示

永远显示在ActionBar中,如果屏幕空间不够则无法显示,ifRoom表示屏幕空间够的情况下显示在ActionBar中,不够的话就显示在overflow中,never则表示永远显示在overflow中。

在Activity中创建ctionBar的Action代码位于onCreateOptionsMenu()中,下面一段代码展示了创建过程:

[java] view
plain
 copy

  1. @Override
  2. public boolean onCreateOptionsMenu(Menu menu) {
  3. MenuInflater inflater = getMenuInflater();
  4. inflater.inflate(R.menu.mainmenu, menu);
  5. return true;
  6. }

2.2 Action的按钮交互

如果一个Action被单击,对于activity中的onOptionsItemSelected()将被调用。该函数的传入参数是一个MenuItem。通过判断该MenuItem的Id,即可确认是哪个Action被单击。下面代码展示了该函数的使用过程。

[java] view
plain
 copy

  1. Override
  2. public boolean onOptionsItemSelected(MenuItem item) {
  3. switch (item.getItemId()) {
  4. // action with ID action_refresh was selected
  5. case R.id.action_refresh:
  6. Toast.makeText(this, "Refresh selected", Toast.LENGTH_SHORT)
  7. .show();
  8. break;
  9. // action with ID action_settings was selected
  10. case R.id.action_settings:
  11. Toast.makeText(this, "Settings selected", Toast.LENG
  12. .show();
  13. break;
  14. default:
  15. break;
  16. }
  17. return true;
  18. }

onCreateOptionsMenu()只会被调用一次。若想改变Menu,可以调用invalidateOptionsMenu(),这会使onCreateOptionsMenu()将会再次被调用。

3. 自定义ActionBar

3.1 改变ActionBar的显示

在运行时显示和隐藏ActionBar的方法如下:

[java] view
plain
 copy

  1. ActionBar actionBar = getActionBar();
  2. actionBar.hide();
  3. // more stuff here...
  4. actionBar.show();

可以改变显示在程序图标旁边的文字,如下所示:

[java] view
plain
 copy

  1. ActionBar actionBar = getActionBar();
  2. actionBar.setSubtitle("mytest");
  3. actionBar.setTitle("vogella.com");

3.2 隐藏导航按钮

可以使用如下代码隐藏导航按钮。

[java] view
plain
 copy

  1. getWindow().
  2. getDecorView().
  3. setSystemUiVisibility(View.SYSTEM_UI_FLAG_HIDE_NAVIGATION);

3.3 使用全屏模式

对于Android 4.4 (API 19)应用程序可以使用全屏模式,如下面代码所示。

[java] view
plain
 copy

  1. // This method hides the system bars and resize the content
  2. private void hideSystemUI() {
  3. getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
  4. | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION // hide nav bar
  5. | View.SYSTEM_UI_FLAG_FULLSCREEN // hide status bar
  6. // remove the following flag for version < API 19
  7. | View.SYSTEM_UI_FLAG_IMMERSIVE);
  8. }

3.4 使用Split action bar

在屏幕很窄时(如在portra模式),使用Split action bar可以将所有的action显示在屏幕底部,这样可以讲更有意义的元素如导航、标题等显示在activity的顶部

启用split action bar可在 AndroidManifest.xml中定义android:uiOptions="SplitActionBarWhenNarrow"

4. 在Fragment中给action bar添加action

在onCreate()中调用 setHasOptionsMenu(true)。Android Framework会调用Fragement中的onCreateOptionsMenu()来向Activity的Menu中添加item。

5. 动态设置action bar

5.1. 自定义action bar中显示的View

可以往action bar中添加自定义的View,如button或text。

可以使用ActionView的setCustomView,然后使用setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM)来Enable自定义View。

例子:先定义一个包含了EditText的布局文件。

[java] view
plain
 copy

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <EditText xmlns:android="http://schemas.android.com/apk/res/android"
  3. android:id="@+id/searchfield"
  4. android:layout_width="match_parent"
  5. android:layout_height="match_parent"
  6. android:inputType="textFilter" >
  7. </EditText>

下面的代码将上述布局文件添加到了一个Activity的action bar中。

[html] view
plain
 copy

  1. package com.vogella.android.actionbar.customviews;
  2. import android.app.ActionBar;
  3. import android.app.Activity;
  4. import android.os.Bundle;
  5. import android.view.KeyEvent;
  6. import android.widget.EditText;
  7. import android.widget.TextView;
  8. import android.widget.TextView.OnEditorActionListener;
  9. import android.widget.Toast;
  10. public class MainActivity extends Activity {
  11. @Override
  12. protected void onCreate(Bundle savedInstanceState) {
  13. super.onCreate(savedInstanceState);
  14. setContentView(R.layout.activity_main);
  15. ActionBar actionBar = getActionBar();
  16. // add the custom view to the action bar
  17. actionBar.setCustomView(R.layout.actionbar_view);
  18. EditText search = (EditText) actionBar.getCustomView().findViewById(R.id.searchfield);
  19. search.setOnEditorActionListener(new OnEditorActionListener() {
  20. @Override
  21. public boolean onEditorAction(TextView v, int actionId,
  22. KeyEvent event) {
  23. Toast.makeText(MainActivity.this, "Search triggered",
  24. Toast.LENGTH_LONG).show();
  25. return false;
  26. }
  27. });
  28. actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM
  29. | ActionBar.DISPLAY_SHOW_HOME);
  30. }
  31. }

完整的源码下载位置:自定义Android
Action Bar的布局

5.2. Action View

Action View控件可以替换Action bar的Action按钮图标。可以利用这个特点将某个Action项替换成一个ProgressBar。可通过android:actionLayout或android:actionViewClass来定义一个布局文件或Widg来作为Action的action view。

Action View使用的效果图如下。

首先是两个布局文件,第一个用于action view

[java] view
plain
 copy

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <ProgressBar xmlns:android="http://schemas.android.com/apk/res/android"
  3. android:id="@+id/progressBar2"
  4. android:layout_width="wrap_content"
  5. android:layout_height="wrap_content">
  6. </ProgressBar>

第二个用于menu设置

[java] view
plain
 copy

  1. <menu xmlns:android="http://schemas.android.com/apk/res/android" >
  2. <item
  3. android:id="@+id/menu_settings"
  4. android:orderInCategory="100"
  5. android:showAsAction="always"
  6. android:title="Settings"
  7. />
  8. <item
  9. android:id="@+id/menu_load"
  10. android:icon="@drawable/navigation_refresh"
  11. android:orderInCategory="200"
  12. android:showAsAction="always"
  13. android:title="Load"/>
  14. </menu>

Activity的代码如下:

[java] view
plain
 copy

  1. package com.vogella.android.actionbar.progress;
  2. import android.app.ActionBar;
  3. import android.app.Activity;
  4. import android.os.AsyncTask;
  5. import android.os.Bundle;
  6. import android.view.Menu;
  7. import android.view.MenuItem;
  8. public class MainActivity extends Activity {
  9. private MenuItem menuItem;
  10. @Override
  11. protected void onCreate(Bundle savedInstanceState) {
  12. super.onCreate(savedInstanceState);
  13. setContentView(R.layout.activity_main);
  14. ActionBar actionBar = getActionBar();
  15. actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_HOME
  16. | ActionBar.DISPLAY_SHOW_TITLE | ActionBar.DISPLAY_SHOW_CUSTOM);
  17. }
  18. @Override
  19. public boolean onCreateOptionsMenu(Menu menu) {
  20. getMenuInflater().inflate(R.menu.main, menu);
  21. return true;
  22. }
  23. @Override
  24. public boolean onOptionsItemSelected(MenuItem item) {
  25. switch (item.getItemId()) {
  26. case R.id.menu_load:
  27. menuItem = item;
  28. menuItem.setActionView(R.layout.progressbar);
  29. menuItem.expandActionView();
  30. TestTask task = new TestTask();
  31. task.execute("test");
  32. break;
  33. default:
  34. break;
  35. }
  36. return true;
  37. }
  38. private class TestTask extends AsyncTask<String, Void, String> {
  39. @Override
  40. protected String doInBackground(String... params) {
  41. // Simulate something long running
  42. try {
  43. Thread.sleep(2000);
  44. } catch (InterruptedException e) {
  45. e.printStackTrace();
  46. }
  47. return null;
  48. }
  49. @Override
  50. protected void onPostExecute(String result) {
  51. menuItem.collapseActionView();
  52. menuItem.setActionView(null);
  53. }
  54. };
  55. }

完整源码的下载地址:动态改变ActionBar的图标

6. Action Provider

Action Provider提供了在单个组件里提供多种交互方式的方法。它可以用来创建action view,动态弹出子menu,处理action调用事件。基类为ActionProvider

目前Android平台提供两种action provider:MediaRouteActionProvider和ShareActionProvider。

下面以一个例子计算ShareActionProvider的用法。使用这个action provider可以让程序从注册了Intent.ACTION_SEND的Intent中获取。

首先定义Menu XML文件,并设置Item的android:actionProviderClass="android.widget.ShareActionProvider"

[java] view
plain
 copy

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <menu xmlns:android="http://schemas.android.com/apk/res/android" >
  3. <item android:id="@+id/menu_share"
  4. android:title="Share"
  5. android:showAsAction="ifRoom"
  6. android:actionProviderClass="android.widget.ShareActionProvider" />
  7. <item
  8. android:id="@+id/item1"
  9. android:showAsAction="ifRoom"
  10. android:title="More entries...">
  11. </item>
  12. </menu>

设置一个包含了想要共享数据的Intent,将其发送。

[java] view
plain
 copy

  1. @Override
  2. public boolean onCreateOptionsMenu(Menu menu) {
  3. getMenuInflater().inflate(R.menu.activity_main, menu);
  4. // Get the ActionProvider for later usage
  5. provider = (ShareActionProvider) menu.findItem(R.id.menu_share)
  6. .getActionProvider();
  7. return true;
  8. }
  9. @Override
  10. public boolean onOptionsItemSelected(MenuItem item) {
  11. switch (item.getItemId()) {
  12. case R.id.menu_share:
  13. doShare();
  14. break;
  15. default:
  16. break;
  17. }
  18. return true;
  19. }
  20. public void doShare() {
  21. // populate the share intent with data
  22. Intent intent = new Intent(Intent.ACTION_SEND);
  23. intent.setType("text/plain");
  24. intent.putExtra(Intent.EXTRA_TEXT, "This is a message for you");
  25. provider.setShareIntent(intent);
  26. }

7. 使用程序图标导航

7.1. 使用程序图标作为home icon

Action Bar的左侧图标称为home icon,可为这个图标设置一个Action。推荐做法是当按了这个图标,返回到Home Activity中。

下面的代码介绍了在Android4.1前的版本上使用home aciton。关键点是在onOptionsMenuItemSelected() 中使用android.R.id.home并启用actionbar的HomeIcon。SecondActivity将MainActivity作为HomeActivity。

[java] view
plain
 copy

  1. package com.vogella.android.actionbar.homebutton;
  2. import android.os.Bundle;
  3. import android.app.ActionBar;
  4. import android.app.Activity;
  5. import android.content.Intent;
  6. import android.view.Menu;
  7. import android.view.MenuItem;
  8. public class SecondActivity extends Activity {
  9. @Override
  10. protected void onCreate(Bundle savedInstanceState) {
  11. super.onCreate(savedInstanceState);
  12. setContentView(R.layout.activity_main);
  13. // enable the home button
  14. ActionBar actionBar = getActionBar();
  15. actionBar.setHomeButtonEnabled(true);//或者使用actionBar.setDisplayHomeAsUpEnabled(true);
  16. }
  17. @Override
  18. public boolean onCreateOptionsMenu(Menu menu) {
  19. getMenuInflater().inflate(R.menu.main, menu);
  20. return true;
  21. }
  22. @Override
  23. public boolean onOptionsItemSelected(MenuItem item) {
  24. switch (item.getItemId()) {
  25. case android.R.id.home:
  26. Intent intent = new Intent(this, MainActivity.class);
  27. intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
  28. startActivity(intent);
  29. break;
  30. // Something else
  31. case R.id.action_settings:
  32. intent = new Intent(this, ThirdActivity.class);
  33. startActivity(intent);
  34. default:
  35. break;
  36. }
  37. return super.onOptionsItemSelected(item);
  38. }
  39. }

在Android 4.1以上版本,可以按如下的方式在AndroidManifest.xml中设置parentActivityName属性。

时间: 2024-10-08 18:44:57

ActionBar的用法的相关文章

Android ActionBar完全解析,使用官方推荐的最佳导航栏(上)

转载请注明出处:http://blog.csdn.net/guolin_blog/article/details/18234477 本篇文章主要内容来自于Android Doc,我翻译之后又做了些加工,英文好的朋友也可以直接去读原文. http://developer.android.com/guide/topics/ui/actionbar.html Action Bar是一种新増的导航栏功能,在Android 3.0之后加入到系统的API当中,它标识了用户当前操作界面的位置,并提供了额外的用

Android学习笔记:ActionBar使用介绍

一.基本概念 最权威和官方的介绍请看google的api文档 http://developer.android.com/training/basics/actionbar/setting-up.html http://developer.android.com/guide/topics/ui/actionbar.html ActionBar故名思意,操作栏的含义,一般位于activity的顶部,可以放置文本标签,搜索框.按钮.图标等.是 Android3才支持的. 在eclipse创建一个默认的

【转】Android ActionBar完全解析,使用官方推荐的最佳导航栏(上)

转载请注明出处:http://blog.csdn.net/guolin_blog/article/details/18234477 本篇文章主要内容来自于Android Doc,我翻译之后又做了些加工,英文好的朋友也可以直接去读原文. http://developer.android.com/guide/topics/ui/actionbar.html Action Bar是一种新増的导航栏功能,在Android 3.0之后加入到系统的API当中,它标识了用户当前操作界面的位置,并提供了额外的用

【Android UI设计与开发】8.顶部标题栏(一)ActionBar 奥义&#183;详解

原文地址:http://www.cnblogs.com/yc-755909659/p/4290784.html 一.ActionBar介绍 在Android 3.0中除了我们重点讲解的Fragment外,Action Bar也是一个非常重要的交互元素,Action Bar取代了传统的tittle bar和menu,在程序运行中一直置于顶部,对于Android平板设备来说屏幕更大它的标题使用Action Bar来设计可以展示更多丰富的内容,方便操控. 二.ActionBar的功能 用图的方式来讲解

【Android UI设计与开发】顶部标题栏(一)ActionBar 奥义&#183;详解

转自:http://www.cnblogs.com/yc-755909659/p/4290784.html 一.ActionBar介绍 在Android 3.0中除了我们重点讲解的Fragment外,Action Bar也是一个非常重要的交互元素,Action Bar取代了传统的tittle bar和menu,在程序运行中一直置于顶部,对于Android平板设备来说屏幕更大它的标题使用Action Bar来设计可以展示更多丰富的内容,方便操控. 二.ActionBar的功能 用图的方式来讲解它的

Android ActionBar通过Tab进行不同的Fragment之间的交换

ActionBar的使用常见于4.0系统,其Tab的使用挺广泛的. 在ActionBar中添加标签(Tabs),每个标签对应的是一个Fragment,点击不同的Tab时,就会切换到对应的Fragment. 大致的步骤如下: 1.如同TabHost控件,每个tab下需要添加内容,这个内容需要结合fragment来显示,因此需创建fragment类,有几个tab就需要几个继承Fragment的类: 2.将fragment添加至ActionBar Tab上,并添加tab监听: 3.监听内部类需要实现A

Android ActionBar完全解析

Action Bar是一种新増的导航栏功能,在Android 3.0之后加入到系统的API当中. 一.Action Bar 功能 1 .标识了用户当前操作界面的位置 2. 提供了额外的用户动作 3. 界面导航等功能. 二.使用ActionBar的好处: 它可以给提供一种全局统一的UI界面,使得用户在使用任何一款软件时都懂得该如何操作,并且ActionBar还可以自动适应各种不同大小的屏幕. 下面是一张使用ActionBar的界面截图: 其中,[1]是ActionBar的图标,[2]是两个acti

ActionBar最全详解

一.ActionBar介绍 在Android 3.0中除了我们重点讲解的Fragment外,Action Bar也是一个非常重要的交互元素,Action Bar取代了传统的tittle bar和menu,在程序运行中一直置于顶部,对于Android平板设备来说屏幕更大它的标题使用Action Bar来设计可以展示更多丰富的内容,方便操控. 二.ActionBar的功能 用图的方式来讲解它的功能 <1> ActionBar的图标,可显示软件图标,也可用其他图标代替.当软件不在最高级页面时,图标左

Android开发笔记(一百一十九)工具栏ToolBar

Toolbar 在前面的博文<Android开发笔记(二十)顶部导航栏>中,我们学习了ActionBar的用法,可是ActionBar着实是不怎么好用,比如文字风格不能定制.图标不能定制,而且还存在低版本的兼容性问题,所以实际开发中大家还是不倾向使用ActionBar.为此,Android提供了加强版的工具栏控件即Toolbar,因为Toolbar继承自ViewGroup,而且可在布局文件中像其它布局视图一样使用,所以灵活性大大的提高了.既然Android都与时俱进了,那我们也不能落后,现在就