上面的效果图其实包含了两种菜单。首先,右上角的那个加号和竖着的三点,是Options菜单。再者,在屏幕正中的这个是Context菜单(上下文菜单)。这两种菜单本文都会讲解。
Options Menu
要开始使用这个菜单,首先回顾一下上文提到的一个重要知识。每次Android的开始都是从视图的布局开始,之后代码通过视图ID获取视图,最后在使用代码处理输入等。
1. 菜单“布局”
现在也不例外,在开始菜单的代码之前首先要有菜单的“布局”。菜单的“布局”略微有一些特殊的地方,这些布局不是放在layout目录下的。所以,我们需要在app/res/目录下建一个menu目录。在res文件夹上右击,选择android resource directory,会弹出一个对话框。在resource type下拉列表里选择menu,之后directory name文本框的内容也会变成menu。最后确定。如下图:
两种菜单的“布局”文件都是放在这个目录下的。
在app/res/menu目录下添加一个菜单文件。在menu目录下右击,选择new->menu resource file,文件名就叫做options_menu_demo.xml,最后确定。文件创建成功后,双击文件打开。添加如下的内容:
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item
android:id="@+id/menu_item_add"
android:icon="@android:drawable/ic_menu_add"
android:title="add something"
app:showAsAction="ifRoom|withText" />
<item
android:id="@+id/menu_item_edit"
android:icon="@android:drawable/ic_menu_edit"
android:title="edit something" />
</menu>
分别讲解下:
- 一个item就是菜单里的一个选项。
- id 什么的就不用多说了,作用都一样。为了在代码里找到这个菜单选项的。
- icon 是菜单选项的图标。我们现在用的这个图标是android系统自带的。
- app:showAsAction是指定options菜单如何显示的。最前面的app是使用了新添加的名称空间:xmlns:app="http://schemas.android.com/apk/res-auto"。没有这个名称空间,app:showAsAction就用不了。这部分后面会有详细的解释。
2. 菜单代码
我们添加了两个菜单项。一个添加,一个删除。下面就该代码部分了。首先新建一个叫做MenuActivity的activity。创建成功后双击打开。
下面需要让Activity知道要创建一个options菜单了。
@Override
public boolean onCreateOptionsMenu(Menu menu) {
MenuInflater inflater = getMenuInflater();
inflater.inflate(R.menu.options_menu_demo, menu);
return true;
}
MenuInflater
是专门用来解析菜单的“布局”文件的。这句inflater.inflate(R.menu.options_menu_demo, menu);
解析options菜单。最后返回true
,告诉Activity菜单都解析好了。这时运行起来就会看到界面右上角的菜单了。
3. 响应菜单的点击
菜单都有了,能看到,能点击。只是点击之后没有什么反应。现在就给菜单添加处理点击的代码:
@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
case R.id.menu_item_add: {
Toast.makeText(this, "Menu item add selected", Toast.LENGTH_SHORT).show();
return true;
}
case R.id.menu_item_edit: {
Toast.makeText(this, "Menu item edit selected", Toast.LENGTH_SHORT).show();
return true;
}
case R.id.ctx_menu_item_add: {
Toast.makeText(this, "Context Menu item edit selected", Toast.LENGTH_SHORT).show();
return true;
}
default: {
return super.onOptionsItemSelected(item);
}
}
}
重写Activity的方法onOptionsItemSelected
。根据用户点选的菜单项的ID,来处理。我们这里只显示一个Toast
,告诉用户点选了哪个菜单项。
Context菜单
基本和上面创建options菜单的过程类似。略有不同。
- 创建一个名为context_menu_demo.xml的上下文菜单文件。
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item
android:id="@+id/ctx_menu_item_add"
android:icon="@android:drawable/ic_menu_add"
android:title="add something"
app:showAsAction="ifRoom|withText" />
<item
android:id="@+id/ctx_menu_item_edit"
android:icon="@android:drawable/ic_menu_edit"
android:title="edit something" />
</menu>
- 在代码中解析上下文菜单文件:
@Override
public void onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo) {
MenuInflater inflater = getMenuInflater();
inflater.inflate(R.menu.context_menu_demo, menu);
}
- 添加处理菜单选项点击的代码
@Override
public boolean onContextItemSelected(MenuItem item) {
switch (item.getItemId()) {
case R.id.ctx_menu_item_add: {
Toast.makeText(this, "Context Menu Add", Toast.LENGTH_SHORT).show();
return true;
}
case R.id.ctx_menu_item_delete: {
Toast.makeText(this, "Context Menu Delete", Toast.LENGTH_SHORT).show();
return true;
}
default: {
return super.onContextItemSelected(item);
}
}
}
到目前为止,不同的地方只在于解析上下文菜单的方法是onCreateContextMenu
处理菜单项点击的方法是onContextItemSelected
。
最后,如果要让上下文菜单起作用,还需要和某个视图绑定。绑定使用方法registerForContextMenu(视图)
。
但是这不是最大的不同。我们来模拟一下微信对话删除的功能。一切功能在开发的时候都从布局开始,给MenuActivity
添加一个ListView
:
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/activity_menu"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context="com.a31day.sixthDay.MenuActivity">
<ListView
android:id="@+id/demo_listView"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:dividerHeight="1px"></ListView>
</RelativeLayout>
要让ListView
运行起来只有布局是不够的,这个视图比较TextView
之类的视图要复杂一些。ListView
还需要一个Adapter
(适配器),我们直接看代码示例:
public class MenuActivity extends AppCompatActivity {
private List<String> dataSource;
private ListView listView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_menu);
// 1
dataSource = getDataSource();
listView = (ListView) findViewById(R.id.demo_listView);
// 2
listView.setAdapter(new ArrayAdapter<String>(this,
android.R.layout.simple_list_item_1,
dataSource));
// 3
registerForContextMenu(listView);
}
private List<String> getDataSource() {
List<String> tempList = new ArrayList<>(20);
for (int i = 0; i < 20; i++) {
tempList.add("Item [" + i + "]");
}
return tempList;
}
// .....其他略.....
}
分步解释:
- 获取数据源,这里是模拟的。具体代码看方法
getDataSource
,已经贴出来了。 - 给
ListView
设置Adapter
(适配器)。代码中的ArrayAdaper<String>
就是适配器,是把数据源dataSource
的数据一个个的和系统内置的布局android.R.layout.simple_list_item_1
匹配起来。适配器初始化的第一个参数是Context
这个几乎每一个视图都要用到,这里就不多解释了。
使用上下文菜单删除的一条记录
不管使用上下文菜单干什么都要在上面说到的方法public boolean onContextItemSelected(MenuItem item)
来处理。我们第一次使用这个方法是在里面添加了Toast
,在用户每次点选了某个菜单选项之后界面会出现一段文字说明用户的操作是什么。
现在我们在case R.id.ctx_menu_item_delete
里处理删除。
case R.id.ctx_menu_item_delete: {
// 1
AdapterView.AdapterContextMenuInfo menuInfo
= (AdapterView.AdapterContextMenuInfo)item.getMenuInfo();
// 2
String dataString = dataSource.get(menuInfo.position);
dataSource.remove(dataString);
ArrayAdapter<String> listViewAdapter = (ArrayAdapter<String>) listView.getAdapter();
// 3
listViewAdapter.notifyDataSetChanged();
return true;
}
分步解释:
- 获取到上下文菜单项的具体信息。其中包括下一步用到的位置信息:
menuInfo.position
。 - 有了位置,就是可以通过位置在数据源中找到该数据。找到之后,删除之。
- 使用获取到的
ListView
的适配器,调用notifyDataSetChanged()
方法通知适配器数据源发生了改变,重新显示数据。
运行一下,列表里的数据已经可以删除了。
字符串资源
在目录app/res/values/有一个文件strings.xml,打开之后你会看到:
<resources>
<string name="app_name">Yo</string>
</resources>
结构是很简单的。基本就是一个键-值组合。name=“”是指定了key(如:name="app_name"
),中间的Yo就是值。
我们现在添加几项:
<resources>
<string name="app_name">Yo</string>
<!--menu items-->
<string name="menu_add">add something</string>
<string name="menu_delete">delete something</string>
<string name="menu_edit">edit something</string>
</resources>
添加的这几项的字符串内容都是菜单项里用到的,添加、删除和编辑。现在我们把这些资源在菜单项里用起来:
<item
android:id="@+id/ctx_menu_item_add"
android:icon="@android:drawable/ic_menu_add"
android:title="@string/menu_add"/>
使用也很简单,只要把原来的字符串内容,对应的替换为@string/menu_add
就可以了。使用的结构就是@string/[资源的name]。
总结
本文详解的介绍了如何创建和使用options菜单以及上下文菜单。还有经常使用到的字符串资源文件。这三者在日常的开发中会经常的使用到,务必多加练习。
字符串资源文件,刚开始看起来非常多余。确实没有这个资源文件也没什么大不了的。但是在日常的维护中要做到“修改一处,处处修改”就一定要用到这个资源文件了。如果你的应用要发布到多个国家,需要用到多语言的时候就更是必须要用到字符串资源文件了。所以,一开始就要养成一个好的习惯。所有的字符串金陵都放在资源文件中。
在文中还给出了ListView相关的代码,可以适当预习。ListView也是以后会经常使用的视图。