android ActionBar与Menu - 1 - api demos 学习

原文地址：http://su1216.iteye.com/blog/1550551

android2.x到现在的4.0有很大的差别，而手机开发者又没有经历过3.x版本的过渡，所以对于手机开发者的压力是比较大的，需要学习和适应大量新的组件与api

 

本文主要总结对ActionBar和Menu的学习

注意：这里以4.0为base

 

作为开发者，应该阅读下面重要新闻

谷歌敦促Android开发者停止使用菜单按钮

先说几句题外话

我个人觉得，应该保留实体menu按键，如果没有实体按键，那应该如何与menu交互？android提供了方案，使用action bar，action bar是显示在屏幕上的

等等，似乎有点问题，这也就是说：如果开发者需要menu，那么就需要消耗一部分屏幕的空间，虽然现在的手机很少有3寸以下的屏幕了，但是也没大到增加一个action bar而不使用户与开发者心疼的地步，起码我是这么觉得的

之前我可以隐藏状态栏标题栏但是保留menu，以后估计不行了

 

开始学习，以api demos - App - Action Bar中内容为主

 

menu的显示方式

boolean android.app.Activity.onCreateOptionsMenu(Menu menu)还是保留下来了的

MenuItem actionItem = menu.add("Action Button");
actionItem.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);

setShowAsAction：设置ActionBar中menu的显示方式

显示方式一共有如下5种：

从不显示;如果有空间就显示;总是显示;显示时跟随文字;默认收缩其action view

/** Never show this item as a button in an Action Bar. */
public static final int SHOW_AS_ACTION_NEVER = 0;
/** Show this item as a button in an Action Bar if the system decides there is room for it. */
public static final int SHOW_AS_ACTION_IF_ROOM = 1;
/**
* Always show this item as a button in an Action Bar.
* Use sparingly! If too many items are set to always show in the Action Bar it can
* crowd the Action Bar and degrade the user experience on devices with smaller screens.
* A good rule of thumb is to have no more than 2 items set to always show at a time.
*/
public static final int SHOW_AS_ACTION_ALWAYS = 2;

/**
* When this item is in the action bar, always show it with a text label even if
* it also has an icon specified.
*/
public static final int SHOW_AS_ACTION_WITH_TEXT = 4;

/**
* This item's action view collapses to a normal menu item.
* When expanded, the action view temporarily takes over
* a larger segment of its container.
*/
public static final int SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW = 8;

其中SHOW_AS_ACTION_WITH_TEXT需要注意一下

在手机中，竖屏状态下text是不会显示的，切换到横屏才会显示text

 

SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW也需要特别说明一下

menu的每个item都可以设置action view，如果设置了，那么这个view默认是显示的，设置了SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW后，则默认不显示

 

另外需要说明的是：

现在手机有两种，一种是有实体按键的手机，不在action bar显示的item，按menu则会看到剩余的item

另一种是没有实体menu键的手机，他们通过action bar等触发menu，所有的item都会在action bar显示，“显示不下”的item会在action bar最后一个item触发显示剩余item列表，类似于之前我们按menu键后出现的“more”

(模拟器中可以选择是否有实体menu按键，编辑模拟器 - hardware - new - hardware back/home keys，添加此项选择no即可去掉实体按键)

 

 

ActionBar还提供了Tab功能

4.0中大家发现：TabActivity已经称为了过时的class，那么新的标签页如何实现，ActionBar提供一种简单的方式

final ActionBar bar = getActionBar();
final int tabCount = bar.getTabCount();
final String text = "Tab " + tabCount;
bar.addTab(bar.newTab()
        .setText(text)
        .setTabListener(new TabListener(new TabContentFragment(text))));

其中TabListener要实现ActionBar.TabListener，并实现如下几个函数

private class TabListener implements ActionBar.TabListener {
    public void onTabSelected(Tab tab, FragmentTransaction ft) {}
    public void onTabUnselected(Tab tab, FragmentTransaction ft) {}
    public void onTabReselected(Tab tab, FragmentTransaction ft) {}
}

 函数从名称就能看出是做什么的了，不再赘述

 

上面是ApiDemos的示例，只需addTab即可

void android.app.ActionBar.addTab(Tab tab)
void android.app.ActionBar.addTab(Tab tab, boolean setSelected)
void android.app.ActionBar.addTab(Tab tab, int position)
void android.app.ActionBar.addTab(Tab tab, int position, boolean setSelected

除此之外，android也提供了remove和removeAll的api，不再列举

 

api demos中给出了Action Bar中使用menu的简单演示，效果如下

  

上面三个menu，下面两个，点击Sort之后弹出二级菜单

只需在xml中进行配置即可

<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/action_search"
          android:icon="@android:drawable/ic_menu_search"
          android:title="@string/action_bar_search"
          android:showAsAction="ifRoom"
          android:actionViewClass="android.widget.SearchView" />
    <item android:id="@+id/action_add"
          android:icon="@android:drawable/ic_menu_add"
          android:title="@string/action_bar_add" />
    <item android:id="@+id/action_edit"
          android:icon="@android:drawable/ic_menu_edit"
          android:showAsAction="always"
          android:title="@string/action_bar_edit" />
    <item android:id="@+id/action_share"
          android:icon="@android:drawable/ic_menu_share"
          android:title="@string/action_bar_share"
          android:showAsAction="ifRoom" />
    <item android:id="@+id/action_sort"
          android:icon="@android:drawable/ic_menu_sort_by_size"
          android:title="@string/action_bar_sort"
          android:showAsAction="ifRoom">
        <menu>
            <item android:id="@+id/action_sort_size"
                  android:icon="@android:drawable/ic_menu_sort_by_size"
                  android:title="@string/action_bar_sort_size"
                  android:onClick="onSort" />
            <item android:id="@+id/action_sort_alpha"
                  android:icon="@android:drawable/ic_menu_sort_alphabetically"
                  android:title="@string/action_bar_sort_alpha"
                  android:onClick="onSort" />
        </menu>
    </item>
</menu>

 

当把手机变成横屏的时候，由于空间充足，Sort就会显示在Action Bar中，下图是点击Sort后的效果

 

我们点击By size和Alphabetically会发现，Sort的图标会跟着改变

public void onSort(MenuItem item) {
    mSortMode = item.getItemId();
    // Request a call to onPrepareOptionsMenu so we can change the sort icon
    invalidateOptionsMenu();
}

invalidateOptionsMenu会通知系统menu发生了改变，触发onPrepareOptionsMenu和onCreateOptionsMenu，然后再看看onPrepareOptionsMenu做了些什么

public boolean onPrepareOptionsMenu(Menu menu) {
    if (mSortMode != -1) {
        Drawable icon = menu.findItem(mSortMode).getIcon();
        menu.findItem(R.id.action_sort).setIcon(icon);
    }
    return super.onPrepareOptionsMenu(menu);
}

调用的时候会判断状态，根据状态设置Sort图标

 

当我们点击Search按钮的时候，它的Action View会显示出来

<item android:id="@+id/action_search"
      android:icon="@android:drawable/ic_menu_search"
      android:title="@string/action_bar_search"
      android:showAsAction="ifRoom"
      android:actionViewClass="android.widget.SearchView" />

xml中显示了Action View调用的是android.widget.SearchView这个class

public boolean onCreateOptionsMenu(Menu menu) {
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.actions, menu);
    SearchView searchView = (SearchView) menu.findItem(R.id.action_search).getActionView();
    searchView.setOnQueryTextListener(this);
    return true;
}

在这里为SearchView设置监听，onQueryTextChange在输入框文字修改时触发，onQueryTextSubmit在提交搜索时触发

 

在xml也可以设置ActionProvider，例如

<item android:id="@+id/menu_item_action_provider_action_bar"
    android:showAsAction="ifRoom"
    android:title="@string/action_bar_settings"
    android:actionProviderClass="com.example.android.apis.app.ActionBarSettingsActionProviderActivity$SettingsActionProvider"/>

ActionProvider的使用暂时不做过多讨论

上面的图片是一个Action Bar，可以分为几个部分，他们都可以设置为显示或者不显示，从左至右依次为：

ActionBar.DISPLAY_HOME_AS_UP：类似于提示作用，上图为一个脱字符（Up caret），不能单独只显示这个。。

ActionBar.DISPLAY_SHOW_HOME：大大的android图片为home，当然这个默认为apk的图标，可以通过ActionBar.DISPLAY_USE_LOGO来设置使用什么图片

ActionBar.DISPLAY_SHOW_TITLE：接下来的是title

ActionBar.DISPLAY_SHOW_CUSTOM：然后是定制的View，可以通过void android.app.ActionBar.setCustomView(View view, LayoutParams layoutParams)设置

 

api demos中关于Action Bar的内容总结完了，我想掌握了这些，基本使用应该是没有问题了，之后打算在android源码中找些实例分析一下，待续

 

 

 

转贴请保留以下链接

本人blog地址

http://su1216.iteye.com/

http://blog.csdn.net/su1216/