AdapterView及子类

AdapterView是一组重要的组件，AdapterView本身是一个抽象基类，它派生的子类在用法上十分相似，只是显示界面有一定的区别。
AdapterView具有如下特征

AdapterView继承ViewGrop，它的本质是容器
AdapterView可以包括多个"列表项"并将多个"列表项"以合适的形式显示出来
AdapterView 显示的多个"列表项"由Adapter提供。调用AdapterView的setAdapter(Adapter)的方法设置Adapter即可。
AdapterView及其子类的继承关系图如下图所示

由上图可以看出AdapterView派生了三个子类：AbsListView、AbsSpinner和AdapterViewAnimator，这三个子类依然是抽象的，实际使用往往采用它们的子类。

由于Gallery是一个过时的API，Android推荐使用HorizonatalScrollViewl来代替它。

ListView介绍

ListView是手机系统中使用非常广泛的一种组件，它以垂直列表的形式显示所有列表项，生成列表视图的两种方式：
- 直接使用ListView创建
- 让Activity继承ListActivity(相当于该Activity显示的组件为ListView)

程序获取ListView后，接下来就需要为ListView设置显示的列表项了，通过setAdapter()方法为之提供Adapter,并由Adapter提供列表项即可。

AbsListView提供的常用XML属性及相关方法：

XML属性	相关方法	说明
Android:choiceMode		设置说明AbsListView的选择行为。该属性支持以下属性值 none :不显示任何选中项 singleChoice:允许单选 multipleChoice:允许多选 multipleChoiceModal：允许多选
Android:drawSelectorOnTop	setDrawSelectorOnTop(boolean)	如果属性设置为true，选中的列表项将会显示在上面
Android:fastScorllEnabled		设置是否允许快速滚动。true将会显示滚动图标，并允许用户拖动该滚动图标进行快速滚动
Android:listSelector	setSelector(int)	指定被选中的列表项上绘制的Drawable
android:scorllingCache		如果设置为true，该组件在滚动时会使用绘制缓存
android：smoothScrollbar	setSmoothScrollbarEnabled(boolean)	如果设置为false，则不在headerView之后绘制分割条
android:stackFromBottom		设置是否从底端开始排列列表项
android:textFilterEnabled		设置是否对列表进行过滤。当该AbsListView对应的Adapter实现了Filter接口时该属性才起作用
android:transcriptMode		设置该组件的滚动模式。该属性有如下属性值：disabled：关闭滚动。这是默认值 normal：当该AbsListView收到数据改变通知，且最后一个列表项可见时，该AbsListView将会滚动到底端 alwaysScrool:该AbsListView总会自动滚动到底端

ListView提供的常用XML属性：

XML属性	说明
android:divider	设置List列表项的分隔条(既可用颜色分隔，也可用Drawable分隔)
android:dividerHeight	设置分隔条的高度
android:entries	指定一个数组资源，Android将根据数组资源来生成ListView
android:footerDividerEnabled	如果设置为false，则不在footerView之后绘制分隔条
android:headerDividerEnabled	如果设置为false，则不在headerView之后绘制分隔条

实例

在界面布局activity_main文件中添加个ListView

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="match_parent"tools:context=".MainActivity"><!--直接使用数组资源给出列表项--><!--使用红色分隔条,高度2px--><ListViewandroid:layout_width="match_parent"android:layout_height="match_parent"app:layout_constraintBottom_toBottomOf="parent"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent"android:divider="#f00"android:dividerHeight="2px"android:entries="@array/books"/>
</androidx.constraintlayout.widget.ConstraintLayout>

上面的界面布局中定义了一个ListView，并通过android:entries指定了列表项数组。还利用了android:divider属性设置分隔条的颜色为红色，android:dividerHeight设置了分隔条的高度为2px
ListView指定了android:entries="@array/books"，该属性值用到了数组资源，因此还需定义一个名为books的数组，定义数组资源文件如下：

values\arrays.xml

<?xml version="1.0" encoding="utf-8"?>
<resources><string-array name="books"><item>Java</item><item>Html</item><item>Android</item><item>C++</item><item>JQuery</item></string-array>
</resources>

效果图：

Adapter接口

Adapter本身只是一个接口，它派生了ListAdapter和SpinnerAdapter两个子接口，其中ListAdapter为AbsListView提供列表项，而SpinnerAdapter为AbsSpinner提供列表项。
Adapter接口及其实现类的继承关系如图所示：

常用的Adapter：BaseAdapter、ArrayAdapter、SimpleAdapter、SimpleCursorAdapter。
从上图可以看出，几乎所有的Adapter都继承了BaseAdapter，而BaseAdapter同时实现了ListAdapter、SpinnerAdapter两个接口，因此BaseAdapter及其子类可以同时为了AbsListView、AbsSpinner提供列表项。
Adapter常用的实现类如下：

ArrayAdapter：简单、易用的Adapter，通常用于数组或List集合的多个值包装成多个列表项。
SimpleAdapter：并不简单、功能强大的Adapter，可用于将List集合的多个对象包装成多个列表项。
SimpleCursorAdapter：与SimpleAdapter基本相似，只是用于包装Cursor提供的数据。
BaseAdapter：通常用于被扩展。扩展BaseAdapter可以对各列表项进行最大限度的定制。

实例

1.通过ArrayAdapter来实现Adapter

布局文件activity.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="match_parent"tools:context=".MainActivity"><!--使用红色分隔条--><ListViewandroid:id="@+id/list1"android:layout_width="match_parent"android:layout_height="0dp"android:divider="#f00"android:dividerHeight="2px"app:layout_constraintBottom_toBottomOf="parent"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintHorizontal_bias="1.0"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent"app:layout_constraintVertical_bias="0.094" /></androidx.constraintlayout.widget.ConstraintLayout>

MainActivity.java文件

import androidx.appcompat.app.AppCompatActivity;import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;public class MainActivity extends AppCompatActivity {@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);/*初始化ListView*/ListView list1 = findViewById(R.id.list1);/*定义一个数组*/String[] arr1 = new String[]{"Java","Android","C++"};/*将数组包装成为ArrayAdapter*/ArrayAdapter<String> adapter1 = new ArrayAdapter<String>(this,R.layout.array_item,arr1);/*为第一个ListView设置Adapter*/list1.setAdapter(adapter1);}
}

上面代码，有一步骤就是把数组包装成ArrayAdapter对象，也就是创建ArrayAdapter对象，创建ArrayAdapter时必须指定如下参数。

Context：上下文，代表访问整个Android应用的接口。
textViewResourceId：一个资源的ID，该资源的ID代表一个TextView，该TextView组件将作为ArrayAdapter的列表组件
数组或List：该数组或List将负责为多个列表项提供数据

创建ArrayAdapter对象中的布局文件 array_item.xml代码如下

<?xml version="1.0" encoding="utf-8"?>
<TextViewxmlns:android="http://schemas.android.com/apk/res/android"android:id="@+id/textView"android:layout_width="match_parent"android:layout_height="match_parent"android:gravity="center"android:textSize="30sp"android:text="TextView" />

效果图

通过以上内容可以看出，数组或List包含多少个元素就会生成多少个列表项，每个列表项都是TextView组件，TextView组件显示的文本由数组或List提供，而array_item.xml文件就是负责每个列表项的组件外观。

2.基于ListActivity实现列表

如果程序的窗口仅仅需要显示一个列表，则可以直接让Activity继承ListActivity来实现，ListActivity的子类无须调用setContentView()方法显示某个界面，而是直接传入一个内容Adapter，ListActivity的子类就呈现一个列表。
MainActivity.java文件

import android.app.ListActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;public class MainActivity extends ListActivity {@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);//无须布局文件String[] arr = new String[]{"JAVA","Android","C++"};//创建ArrayAdapter对象ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,R.layout.array_item,arr);//设置窗口显示列表setListAdapter(adapter);}
}

上面程序Activity继承ListActivity，ListActivity无须界面布局文件——相当于它的布局文件只有一个ListView，因此只要为ListActicity设置Adapter即可

3.使用SimpleAdapter创建ListView

使用ArrayAdapter实现Adapter虽然简单、易用，但ArrayAdapter的功能比较有限，它的每个列表项只能是TextView。如果需要更复杂的列表项，则可以考虑使用SimpleAdapter，SimpleAdapter，功能非常强大，ListView的大部分应用场景，都可以通过SimpleAdapter实现。

界面布局文件：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="match_parent"tools:context=".MainActivity"><!--使用红色分隔条--><ListViewandroid:id="@+id/list1"android:layout_width="0dp"android:layout_height="0dp"app:layout_constraintBottom_toBottomOf="parent"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintHorizontal_bias="1.0"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent"/>
</androidx.constraintlayout.widget.ConstraintLayout>

Activity代码

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.SimpleAdapter;import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;public class MainActivity extends AppCompatActivity {private String[] platfroms = new String[]{"eclipse","webstorm","as"};private String[] languages = new String[]{"JAVA","HTML","ANDROID"};private int[]  images = new int[]{R.drawable.eclipse,R.drawable.webstorm,R.drawable.studio};private ListView listView;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);/*初始化listView*/listView = findViewById(R.id.list);/*创建一个List集合，List集合的元素是Map*/List<Map<String,Object>> maplist = new ArrayList<Map<String, Object>>();for(int i=0;i<platfroms.length;i++){Map<String,Object> map = new HashMap<String, Object>();map.put("image",images[i]);map.put("platfroms",platfroms[i]);map.put("languages",languages[i]);maplist.add(map);}/*创建一个SimpleAdapter*/SimpleAdapter simpleAdapter = new SimpleAdapter(this,maplist,R.layout.simple_item,new String[]{"image","platfroms","languages"},new int[]{R.id.sim_img,R.id.sim_tv1,R.id.sim_tv2});/*为ListView设置Adapter*/listView.setAdapter(simpleAdapter);}
}

创建SimpleAdapter对象需要五个参数：

第一个参数：上下文。
第二个参数：一个List<?extends Map<String,? >>类型的集合对象，该集合中的每个Map<String,? >对象生成一个列表项。
第三个参数：该参数指定一个界面布局的ID。
第四个参数：该参数应该是个String[]类型的参数，该参数决定提取Map<String,? >对象中那些key对应的Value来生成列表项
第五个参数：该参数应该是个int[] 类型的参数，该参数决定填充那些组件

列表项布局文件simple_item.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"android:orientation="vertical" android:layout_width="match_parent"android:layout_height="match_parent"><LinearLayoutandroid:layout_width="match_parent"android:layout_height="50dp"><ImageViewandroid:id="@+id/sim_img"android:layout_width="0dp"android:layout_height="wrap_content"android:layout_weight="1"android:scaleType="centerInside"app:srcCompat="@android:drawable/sym_def_app_icon" /><LinearLayoutandroid:layout_width="0dp"android:layout_height="match_parent"android:layout_weight="3"android:orientation="vertical"><TextViewandroid:id="@+id/sim_tv1"android:layout_width="wrap_content"android:layout_height="0dp"android:layout_weight="2"android:textSize="20sp"android:gravity="center"android:text="TextView" /><TextViewandroid:id="@+id/sim_tv2"android:layout_width="wrap_content"android:layout_height="0dp"android:layout_weight="1"android:gravity="center"android:textSize="15sp"android:text="TextView" /></LinearLayout></LinearLayout></LinearLayout>

效果图：

SimpleAdapter同样可以作为ListActivity的内容Adapter。

如果需要监听用户单击、选中某个列表项的事件，则可以通过AdapterView的setOnItemClickListener()方法为单击事件添加监听器，或者通过setOnItemSelectedListener()方法为列表项的选中事件添加监听器。

  /*为listView的列表项添加单击事件监听器*/listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {@Overridepublic void onItemClick(AdapterView<?> adapterView, View view, int i, long l) {System.out.println(platfroms[i]+"被单击");}});/*为listView的列表项添加选中事件监听器*/listView.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {@Overridepublic void onItemSelected(AdapterView<?> adapterView, View view, int i, long l) {System.out.println(platfroms[i]+"被选中");}@Overridepublic void onNothingSelected(AdapterView<?> adapterView) {}});

LogCat控制台输出