Android ActionBar的基本用法

1、ActionBar的简介

ActionBar位于Activity的顶部，可用来显示activity的标题、Icon、Actions和一些用于交互的View。它也可被用于应用的导航。
ActionBar 是在Android 3.0(API 11）中加入到SK中的，想在低版本中使用ActionBar需要Support Library v7。
下面是一张使用ActionBar的界面截图：

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

2、使用ActionBar

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

menu.xml

<menu xmlns:android="http://schemas.android.com/apk/res/android" >  
    <item  
        android:id="@+id/menu_refresh"  
        android:orderInCategory="100"  
        android:showAsAction="always"  
        android:icon="@drawable/ic_action_refresh"  
        android:title="刷新"/>  
    <item  
        android:id="@+id/action_settings"  
        android:title="设置">  
    item>  
menu>  

showAsAction属性用来定义每个Action是如何显示的，always表示
永远显示在ActionBar中，如果屏幕空间不够则无法显示，ifRoom表示屏幕空间够的情况下显示在ActionBar中，不够的话就显示在overflow中，never则表示永远显示在overflow中。
在Activity中创建ctionBar的Action代码位于onCreateOptionsMenu()中

@Override  
  public boolean onCreateOptionsMenu(Menu menu) {  
    MenuInflater inflater = getMenuInflater();  
    inflater.inflate(R.menu.mainmenu, menu);  
    return true;  
  }   

2.2 Action的按钮交互

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

@Override  
  public boolean onOptionsItemSelected(MenuItem item) {  
    switch (item.getItemId()) {  
    // action with ID action_refresh was selected  
    case R.id.menu_refresh:  
      Toast.makeText(this, "Refresh selected", Toast.LENGTH_SHORT)  
          .show();  
      break;  
    // action with ID action_settings was selected  
    case R.id.menu_settings:  
      Toast.makeText(this, "Settings selected", Toast.LENG  
          .show();  
      break;  
    default:  
      break;  
    }  
    return true;  
  }   

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

3. 自定义ActionBar

3.1 改变ActionBar的显示
在运行时显示和隐藏ActionBar的方法如下：

ActionBar actionBar = getActionBar();  
actionBar.hide();  
// more stuff here...  
actionBar.show();   

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

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

3.2 隐藏导航按钮

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

getWindow().  
  getDecorView().  
  setSystemUiVisibility(View.SYSTEM_UI_FLAG_HIDE_NAVIGATION);   

3.3 使用全屏模式

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

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

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 xmlns:android="http://schemas.android.com/apk/res/android"  
    android:id="@+id/searchfield"  
    android:layout_width="match_parent"  
    android:layout_height="match_parent"  
    android:inputType="textFilter" >  

EditText>  

MainActivity.java中加载

 ActionBar actionBar = getActionBar();  
    // add the custom view to the action bar  
    actionBar.setCustomView(R.layout.actionbar_view);  
    EditText search = (EditText) actionBar.getCustomView().findViewById(R.id.searchfield);  
    search.setOnEditorActionListener(new OnEditorActionListener() {  

      @Override  
      public boolean onEditorAction(TextView v, int actionId,  
          KeyEvent event) {  
        Toast.makeText(MainActivity.this, "Search triggered",  
            Toast.LENGTH_LONG).show();  
        return false;  
      }  
    });  
    actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM  
        | ActionBar.DISPLAY_SHOW_HOME);  
  }  

5.2. Action View

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

自定义xml

  
<ProgressBar xmlns:android="http://schemas.android.com/apk/res/android"  
        android:id="@+id/progressBar2"  
        android:layout_width="wrap_content"  
        android:layout_height="wrap_content">  

ProgressBar>   

menu.xml

<menu xmlns:android="http://schemas.android.com/apk/res/android" >  

    <item  
        android:id="@+id/menu_settings"  
        android:orderInCategory="100"  
        android:showAsAction="always"  
        android:title="Settings"  
        />  

    <item  
        android:id="@+id/menu_load"  
        android:icon="@drawable/navigation_refresh"  
        android:orderInCategory="200"  
        android:showAsAction="always"  
        android:title="Load"/>  

menu>  

public class MainActivity extends Activity {  

  private MenuItem menuItem;  

  @Override  
  protected void onCreate(Bundle savedInstanceState) {  
    super.onCreate(savedInstanceState);  
    setContentView(R.layout.activity_main);  
    ActionBar actionBar = getActionBar();  
    actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_HOME  
        | ActionBar.DISPLAY_SHOW_TITLE | ActionBar.DISPLAY_SHOW_CUSTOM);  
  }  

  @Override  
  public boolean onCreateOptionsMenu(Menu menu) {  
    getMenuInflater().inflate(R.menu.main, menu);  
    return true;  
  }  

  @Override  
  public boolean onOptionsItemSelected(MenuItem item) {  
    switch (item.getItemId()) {  
    case R.id.menu_load:  
      menuItem = item;  
      menuItem.setActionView(R.layout.progressbar);  
      menuItem.expandActionView();  
      TestTask task = new TestTask();  
      task.execute("test");  
      break;  
    default:  
      break;  
    }  
    return true;  
  }  

  private class TestTask extends AsyncTask<String, Void, String> {  

    @Override  
    protected String doInBackground(String... params) {  
      // Simulate something long running  
      try {  
        Thread.sleep(2000);  
      } catch (InterruptedException e) {  
        e.printStackTrace();  
      }  
      return null;  
    }  

    @Override  
    protected void onPostExecute(String result) {  
      menuItem.collapseActionView();  
      menuItem.setActionView(null);  
    }  
  };  
}   

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"

  
<menu xmlns:android="http://schemas.android.com/apk/res/android" >  

   <item android:id="@+id/menu_share"  
          android:title="Share"  
          android:showAsAction="ifRoom"  
          android:actionProviderClass="android.widget.ShareActionProvider" />  
    <item  
        android:id="@+id/item1"  
        android:showAsAction="ifRoom"  
        android:title="More entries...">  
    item>  

menu>   

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

@Override  
  public boolean onCreateOptionsMenu(Menu menu) {  
    getMenuInflater().inflate(R.menu.activity_main, menu);  

    // Get the ActionProvider for later usage  
    provider = (ShareActionProvider) menu.findItem(R.id.menu_share)  
        .getActionProvider();  
    return true;  
  }  

  @Override  
  public boolean onOptionsItemSelected(MenuItem item) {  
    switch (item.getItemId()) {  
    case R.id.menu_share:  
      doShare();  
      break;  
    default:  
      break;  
    }  
    return true;    
  }  

  public void doShare() {  
    // populate the share intent with data  
    Intent intent = new Intent(Intent.ACTION_SEND);  
    intent.setType("text/plain");  
    intent.putExtra(Intent.EXTRA_TEXT, "This is a message for you");  
    provider.setShareIntent(intent);  
  }  

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。

public class SecondActivity extends Activity {  

  @Override  
  protected void onCreate(Bundle savedInstanceState) {  
    super.onCreate(savedInstanceState);  
    setContentView(R.layout.activity_main);  

    // enable the home button  
    ActionBar actionBar = getActionBar();  
    actionBar.setHomeButtonEnabled(true);//或者使用actionBar.setDisplayHomeAsUpEnabled(true);  
  }  

  @Override  
  public boolean onCreateOptionsMenu(Menu menu) {  
    getMenuInflater().inflate(R.menu.main, menu);  
    return true;  
  }  

  @Override  
  public boolean onOptionsItemSelected(MenuItem item) {  
    switch (item.getItemId()) {  
    case android.R.id.home:  
      Intent intent = new Intent(this, MainActivity.class);  
      intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);  
      startActivity(intent);  
      break;  
      // Something else  
    case R.id.action_settings:  
      intent = new Intent(this, ThirdActivity.class);  
      startActivity(intent);  
    default:  
      break;  
    }  
    return super.onOptionsItemSelected(item);  
  }  

}