Android Contextual Menus之一:floating context menu

 

Android Contextual Menus之一:floating context menu

 

上下文菜单

  上下文相关的菜单(contextual menu)用来提供影响UI中特定item或者context frame的动作。

  你可以为任何View提供上下文菜单,但是最常见的使用场景是在ListView、GridView或者其他集合类控件中的项目上,这样用户就可以对特定的项目执行一些直接的操作。

 

  有两种方式来提供上下文相关的动作:

  1.用悬浮上下文菜单( floating context menu)。

  当用户在支持上下文菜单的View上执行长按动作的时候,菜单以一种悬浮列表的方式出现,类似于对话框。

  用户可以每次选择一个菜单项,执行一个上下文相关的动作。

 

  2.用上下文相关的动作模式(contextual action mode)。

  这种模式是ActionMode的系统实现,在屏幕上方展示一个上下文相关的action bar,里面有一些action items,可以用来执行选定项目的相关动作。

  当这种模式active时,用户可以一次对多个项目执行操作。

 

  注意:虽然contextual action mode是更为推崇的一种方式,但是它是Android 3.0(API Level 11)之后才有的,如果要兼容3.0之前的系统,那就应该用floating context menu。

 

创建floating context menu

  提供悬浮上下文菜单的步骤如下:

  1.通过调用registerForContextMenu()方法注册上下文菜单相关的View。

  如果你的activity中用了ListView或者GridView,而且你想其中的每一个item都提供相同的上下文菜单,那么你可以在registerForContextMenu() 中传递这个ListView或GridView。

  2.在Activity或Fragment中实现 onCreateContextMenu()方法。

  当注册过的View接收到长按事件,系统会调用onCreateContextMenu()方法。

  这里你可以定义菜单项,通常是inflate一个菜单资源,比如:

@Override
public void onCreateContextMenu(ContextMenu menu, View v,
                                ContextMenuInfo menuInfo) {
    super.onCreateContextMenu(menu, v, menuInfo);
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.context_menu, menu);
}

 

  这里MenuInflater允许你通过inflate menu resource来得到一个上下文菜单。

  这个回调方法的参数包含了一个用户选择的View和一个ContextMenu.ContextMenuInfo对象,该对象提供了当前选择的item的一些附加信息。

  如果你的activity有多个views,每个提供不同的上下文菜单,你可以用这些参数来决定当前要inflate那个上下文菜单。

 

  3.实现onContextItemSelected()方法

  当用户选择了一个菜单项,系统会调用onContextItemSelected()方法,你可以执行相应的动作,比如:

@Override
public boolean onContextItemSelected(MenuItem item) {
    AdapterContextMenuInfo info = (AdapterContextMenuInfo) item.getMenuInfo();
    switch (item.getItemId()) {
        case R.id.edit:
            editNote(info.id);
            return true;
        case R.id.delete:
            deleteNote(info.id);
            return true;
        default:
            return super.onContextItemSelected(item);
    }
}

 

  其中getItemId()方法得到每个菜单项的id值。

 

  当成功处理了一个菜单项之后,返回true。

  如果你没有处理一个菜单项,你应该把这个菜单项转给它的基类实现。

  如果你的activity包含fragment,activity先接收到这个回调。

  当未处理而调用基类实现时,系统会将这个事件传递到每个fragment各自相应的回调方法中,按照fragment添加的顺序,每次一个,直到返回true或者false。

  Activity和Fragment的默认实现都是返回false,所以你应该永远在未处理的时候调用基类实现。

 

一个简单的例子

  实现的效果就是长按TextView之后显示一个上下文菜单,含两个菜单项,点击菜单项之后显示Toast。

  Activity代码:

package com.example.mengdd.hellocontextmenu;

import android.os.Bundle;
import android.app.Activity;
import android.view.ContextMenu;
import android.view.MenuInflater;
import android.view.MenuItem;
import android.view.View;
import android.view.ContextMenu.ContextMenuInfo;
import android.widget.TextView;
import android.widget.Toast;

public class HelloContextMenuMainActivity extends Activity {

    private TextView mTextView1 = null;

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

        mTextView1 = (TextView) findViewById(R.id.textView1);

        // 注册要弹出ContextMenu的View
        registerForContextMenu(mTextView1);

    }

    @Override
    public void onCreateContextMenu(ContextMenu menu, View v,
            ContextMenuInfo menuInfo) {
        // 第二个参数为当前点击的view

        super.onCreateContextMenu(menu, v, menuInfo);

        MenuInflater inflater = getMenuInflater();
        // 把布局inflate进menu对象
        inflater.inflate(R.menu.context_menu1, menu);
    }

    @Override
    public boolean onContextItemSelected(MenuItem item) {

        boolean result = false;
        switch (item.getItemId()) {
        case R.id.edit:

            Toast.makeText(HelloContextMenuMainActivity.this, "Edit",
                    Toast.LENGTH_LONG).show();
            result = true;
            break;
        case R.id.help:
            Toast.makeText(HelloContextMenuMainActivity.this, "Help",
                    Toast.LENGTH_LONG).show();
            result = true;
            break;
        default:
            result = super.onContextItemSelected(item);
            break;

        }

        return result;

    }

}

 

  Activity的内容布局:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context=".HelloContextMenuMainActivity" >

    <TextView
        android:id="@+id/textView1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/hello_world" />

</LinearLayout>

 

  Menu的布局:

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android" >

    <item
        android:id="@+id/edit"
        android:showAsAction="ifRoom"
        android:title="edit"/>
    <item
        android:id="@+id/help"
        android:title="help"/>

</menu>

 

 

参考资料

  API Guides: Menus->Creating Contextual Menus

  http://developer.android.com/guide/topics/ui/menus.html#context-menu

 

 

你可能感兴趣的:(android)