Android开发笔记(三十八)列表类视图

AdapterView

AdapterView顾名思义是适配器视图,Spinner、ListView和GridView都间接继承自AdapterView,这三个视图都存在多个元素并排展示的情况,所以需要引入适配器模式。
适配器视图的特点有:
1、定义了适配器的设置方法setAdapter,以及获取方法getAdapter。适配器用于传入视图展示需要的相关数据。
2、定义了一个数据观察者AdapterDataSetObserver,用于在列表数据发生变化时,可以通过notifyDataSetChanged方法来更新视图。
3、定义了单个元素的点击、长按、选中事件。其中点击方法为setOnItemClickListener,点击监听器为OnItemClickListener;长按方法为setOnItemLongClickListener,长按监听器为OnItemLongClickListener;选中方法为setOnItemSelectedListener,选中监听器为OnItemSelectedListener。


Adapter

适配器Adapter与适配视图是配合使用的,每个适配类视图都要搭配相应的适配器,才能够正常工作。Adapter派生出两个接口SpinnerAdapter和ListAdapter,然后BaseAdapter又同时实现了SpinnerAdapter和ListAdapter,所以实际开发中用的是BaseAdapter及其派生出的子类。


一般情况下自定义适配器继承自BaseAdapter就够用了,当然Android为了方便懒人,专门扩展了两种简单易用的适配器,如ArrayAdapter用于每行只显示文本的情况,而SimpleAdapter用于每行显示左图标右文本的情况。实际开发中,ArrayAdapter多用于Spinner,但是SimpleAdapter却很少使用。像ListView和GridView一般都是直接使用BaseAdapter,并不使用布局过于简单的SimpleAdapter。


Spinner

Spinner是下拉框,用于从一串列表中选择某项。下面是Spinner常用的属性和方法:
xml布局上的属性设置:
prompt : 指定弹窗的标题视图,在spinnerMode=dialog时有效。该属性值不可直接填字符串,但可通过"@string/..."方式来指定标题文字。
spinnerMode : 下拉列表的显示样式,有dialog弹窗和dropdown下拉两种。不过考虑到用户体验,实际开发中一般用dialog。spinnerMode只能在xml中设置,不能在代码中设置。
代码中的方法:
setPrompt : 设置标题文字。
setPromptId : 设置标题视图的资源ID。
setSelection : 设置当前选中哪项。
setAdapter : 设置适配器。源码中的适配器类型是SpinnerAdapter,但该类用起来很麻烦,所以实际中用的一般是ArrayAdapter<String>,ArrayAdapter可以直接传入一个字符串数组。
setOnItemSelectedListener : 设置下拉列表的选中监听器。


下面是Spinner调用的代码例子:
		ArrayAdapter<String> starAdapter = new ArrayAdapter<String>(this,
				R.layout.spinner_item, starArray);
		starAdapter.setDropDownViewResource(R.layout.spinner_dropdown_item);
		Spinner sp = (Spinner) findViewById(R.id.sp_hello);
		sp.setPrompt("请选择行星");
		sp.setAdapter(starAdapter);
		sp.setOnItemSelectedListener(new MySelectedListener());


	private String[] starArray = {"水星", "金星", "地球", "火星", "木星", "土星"};
	class MySelectedListener implements OnItemSelectedListener {
		public void onItemSelected(AdapterView<?> arg0, View arg1, int arg2, long arg3) {
			Toast.makeText(MainActivity.this, "您选择的是"+starArray[arg2], Toast.LENGTH_LONG).show();
		}


		public void onNothingSelected(AdapterView<?> arg0) {
		}
	}


代码中用到的spinner_item元素布局的示例如下:
<TextView xmlns:android="http://schemas.android.com/apk/res/android" 
    android:id="@android:id/text1"
    style="?android:attr/spinnerItemStyle"
    android:singleLine="true"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:ellipsize="marquee"
    android:textAlignment="inherit"
    android:textSize="17sp"
    android:textColor="#0000ff" />
上面这个xml布局用到了TextView的三个新属性,说明如下:
singleLine : 指定是否单行显示,取值true表示单行,false表示多行。代码中对应的方法是setSingleLine。
ellipsize : 指定字符超出TextView区域时的显示方式,取值说明如下:start表示在字符串开头显示省略号,end表示在字符串末尾显示省略号,middle表示在字符串中间显示省略号,marquee表示以跑马灯方式显示字符串(即从左向右循环滚动,跑马灯方式需同时指定singleLine为true)。代码中对应的方法是setEllipsize。
textAlignment : 指定文本的对齐方式,常见的取值说明如下:inherit表示继承上级视图的对齐方式,center表示文本居中对齐,textStart表示文本开头对齐,textEnd表示文本末尾对齐,viewStart表示视图开头对齐,viewEnd表示视图末尾对齐。该属性在API17后增加,即Android4.2.2以上版本才支持。代码中对应的方法是setTextAlignment。


ListView

ListView是列表视图,用于分行显示列表信息。下面是ListView常用的属性和方法:

ListView的属性和方法

xml布局上的属性设置:
divider : 指定分隔线的图形。如需取消分隔线,可设置该属性值为@null
dividerHeight : 指定分隔线的高度。注意如果divider设置为@null时,就不可将dividerHeight设置为大于0dp的数值,因为这样可能导致末尾的元素显示不全。
headerDividersEnabled : 指定是否显示列表开头的分隔线。但实际开发中发现这个设置不起作用,即使该属性设置为true,开头也不会显示分隔线。查看ListView的源码,发现分隔线是画在子视图的下方,所以列表上方的分隔线就画不出来了。有种情况是例外,就是如果stackFromBottom设置为true,表示列表从下往上显示,那么此时会显示列表上方的分隔线,而不会显示列表下方的分隔线了。
footerDividersEnabled : 指定是否显示列表末尾的分隔线。
stackFromBottom : 指定列表项是否从下往上显示。


代码中的方法:
setDivider : 设置分隔线的图形。
setDividerHeight : 设置分隔线的高度。
setHeaderDividersEnabled : 设置是否显示列表开头的分隔线。该方法实际上不起作用。
setFooterDividersEnabled : 设置是否显示列表末尾的分隔线。
setStackFromBottom : 设置列表项是否从下往上显示。
setAdapter : 设置适配器。ListView使用的适配器一般继承自BaseAdapter。
setOnItemClickListener : 设置点击事件的监听器。
setOnItemLongClickListener : 设置长按事件的监听器。


总结ListView的属性设置有两个注意点(不知算不算Android的bug,呵呵):
1、divider设置为@null时,就不能再设置dividerHeight为非0值,不然列表末尾元素显示有问题;
2、不管是否指定headerDividersEnabled,列表上方的分隔线都不会显示;


ListView的使用方式

Android提供了两种使用ListView的方式:
1、ListActivity方式。首先xml布局中将ListView的id设置为系统id,即“@android:id/list”,然后页面的代码类继承ListActivity。该方式无需在代码中获取ListView的对象,直接调用setListAdapter方法设置适配器,同时实现ListActivity的点击方法onListItemClick来响应点击事件。
2、普通Activity方式。xml布局中ListView的id可自定义,页面的代码类继承自Activity。该方式要从布局文件中获取ListView的对象,然后调用该对象的setAdapter方法设置适配器,并调用ListView对象的setOnItemClickListener方法来设置点击事件的监听器。


两种使用方式的区别如下:
1、ListActivity方式的视图id被设置为系统id,不方便在代码中修改该列表视图的属性;
2、ListActivity方式只实现点击方法、未实现长按方法,不方便响应列表项的长按事件。
3、实际开发中经常自己写个Activity的基类,具体页面都从该Activity基类派生出来。如果有个页面采用ListActivity方式,就无法继承使用这个Activity基类了。
从上面可以看出,ListActivity方式的限制较多,所以实际开发中我们还是使用普通Activity方式来开发ListView。


ListView的示例代码

下面是适配器的代码例子:
import java.util.ArrayList;

import com.example.exmsimplewidgte.R;

import android.annotation.SuppressLint;
import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.AdapterView.OnItemLongClickListener;
import android.widget.BaseAdapter;
import android.widget.TextView;
import android.widget.Toast;

@SuppressLint({ "DefaultLocale", "InflateParams" })
public class TitleListAdapter extends BaseAdapter 
	implements OnItemClickListener, OnItemLongClickListener {

	private ArrayList<String> mTitleList;
	private LayoutInflater mInflater;
	private Context mContext;

	public TitleListAdapter(Context context, String[] title_list) {
		this.mInflater = LayoutInflater.from(context);
		mContext = context;
		mTitleList = new ArrayList<String>();
		for (int i=0; i<title_list.length; i++) {
			mTitleList.add(title_list[i]);
		}
	}

	@Override
	public int getCount() {
		return mTitleList.size();
	}

	@Override
	public Object getItem(int arg0) {
		return mTitleList.get(arg0);
	}

	@Override
	public long getItemId(int arg0) {
		return arg0;
	}

	@Override
	public View getView(final int position, View convertView, ViewGroup parent) {
		ViewHolder holder = null;
		if (convertView == null) {
			holder = new ViewHolder();
			convertView = mInflater.inflate(R.layout.list_title, null);
			holder.tv_seq = (TextView) convertView.findViewById(R.id.tv_seq);
			holder.tv_title = (TextView) convertView.findViewById(R.id.tv_title);
			convertView.setTag(holder);
		} else {
			holder = (ViewHolder) convertView.getTag();
		}

		holder.tv_seq.setText(""+(position+1));
		holder.tv_title.setText(mTitleList.get(position));
		return convertView;
	}

	public final class ViewHolder {
		public TextView tv_seq;
		public TextView tv_title;
	}

	@Override
	public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
		String desc = String.format("您点击了第%d项,该项的标题是%s", 
				position+1, mTitleList.get(position));
		Toast.makeText(mContext, desc, Toast.LENGTH_LONG).show();
	}

	@Override
	public boolean onItemLongClick(AdapterView<?> parent, View view,
			int position, long id) {
		String desc = String.format("您长按了第%d项,该项的标题是%s", 
				position+1, mTitleList.get(position));
		Toast.makeText(mContext, desc, Toast.LENGTH_LONG).show();
		return true;
	}

}


下面是ListView的调用代码例子:
		String[] weekArray = {"星期一", "星期二", "星期三", "星期四", "星期五"};
		TitleListAdapter titleAdapter = new TitleListAdapter(this, weekArray);
		ListView lv_hello = (ListView) findViewById(R.id.lv_hello);
		lv_hello.setFooterDividersEnabled(true);
		lv_hello.setAdapter(titleAdapter);
		lv_hello.setOnItemClickListener(titleAdapter);
		lv_hello.setOnItemLongClickListener(titleAdapter);



GridView

GridView是网格视图,用于分行分列显示表格信息。下面是GridView常用的属性和方法:
xml布局上的属性设置:
horizontalSpacing : 指定子视图在水平方向的间距。
verticalSpacing : 指定子视图在垂直方向的间距。
columnWidth : 指定每列的宽度。
numColumns : 指定列的数目。
stretchMode : 指定拉伸的模式。取值说明如下:none表示不做拉伸;columnWidth表示若有空余空间,则拉伸与列宽大小一致;spacingWidth表示若有空余空间,则列宽不变,把空余分配到每列间的空隙;spacingWidthUniform与spacingWidth的区别在于,Uniform方式在每列左边和右边都补上空隙(即每行开头和末尾都补空隙),而spacingWidth在每行开头和末尾不补空隙,只有列与列之间才补空隙。实际开发中一般把模式设置为columnWidth。


代码中的方法:
setHorizontalSpacing : 设置子视图在水平方向的间距。
setVerticalSpacing : 设置子视图在垂直方向的间距。
setColumnWidth : 设置每列的宽度。
setNumColumns : 设置列的数目。
setStretchMode : 设置拉伸的模式。
setAdapter : 设置适配器。GridView使用的适配器一般继承自BaseAdapter。
setOnItemClickListener : 设置点击事件的监听器。
setOnItemLongClickListener : 设置长按事件的监听器。


实际开发中有时需要设置网格之间表格线的颜色,可惜GridView并未直接给出相应的属性和方法,那得变通处理一下。具体的说,就是给GridView设置整个网格的背景色(例如黑色),以及网格之间的水平间距和垂直间距;然后给每项网格的根布局设置背景色(例如白色),这样只有网格间距是黑色,从而间接画上了黑色表格线。


GridView的适配器模板与ListView是一样的,只要换掉代码里的布局文件名以及相关控件名称就好了,所以不再重复贴出GridView的适配器代码。下面是GridView的调用代码例子:
		String[] yearArray = {"鼠年", "牛年", "虎年", "兔年", "龙年", "蛇年",
				"马年", "羊年", "猴年", "鸡年", "狗年", "猪年"};
		ContentGridAdapter contentAdapter = new ContentGridAdapter(this, yearArray);
		GridView gv_hello = (GridView) findViewById(R.id.gv_hello);
		gv_hello.setNumColumns(5);
		gv_hello.setStretchMode(GridView.STRETCH_COLUMN_WIDTH);
		gv_hello.setHorizontalSpacing(1);
		gv_hello.setVerticalSpacing(1);
		gv_hello.setAdapter(contentAdapter);
		gv_hello.setOnItemClickListener(contentAdapter);
		gv_hello.setOnItemLongClickListener(contentAdapter);




点此查看Android开发笔记的完整目录




你可能感兴趣的:(android,Spinner,ListView,GridView,adapterview)