Android 中文API (46) —— SimpleAdapter

简介:

正文

  一、结构

    public interface SpinnerAdapter extends Adapter

 

 

  java.lang.Object

       android.widget.BaseAdapter

android.widget. SpinnerAdapter

 

  二、概述

    这是一个简单的适配器,可以将静态数据映射到XML文件中定义好的视图。你可以指定数据支持的列表如ArrayList组成的Map。在ArrayList中的每个条目对应List中的一行。Maps包含每行数据。你可以指定一个定义了被用于显示行的视图XML文件,通过关键字映射到指定的视图。绑定数据到视图分两个阶段,首先,如果一个SimpleAdapter.ViewBinder是有效的,setViewValue(android.view.View, Object, String)将被调用。如果返回值是真,绑定完成了。如果返回值为假,下面的视图将按以下顺序去处理:

     一个实现了Checkable的视图(例如CheckBox),期望绑定值是一个布尔类型。

     TextView期望绑定值是一个字符串类型,通过调用setViewText(TextView, String)绑定。

     ImageView期望绑定值是一个资源id或者一个字符串,通过调用setViewImage(ImageView, int)    setViewImage(ImageView, String)

    如果没有一个合适的绑定发生将会抛出IllegalStateException

 

  三、构造函数

public SimpleAdapter (Context context, List<? extends Map<String, ?>> data, int resource, String[] from, int[] to)

        构造函数

参数

       context   关联SimpleAdapter运行着的视图的上下文。

data        一个Map的列表。在列表中的每个条目对应列表中的一行,应该包含所有在from中指定的条目

resource              一个定义列表项目的视图布局的资源唯一标识。布局文件将至少应包含哪些在to中定义了的名称。

from       一个将被添加到Map上关联每一个项目的列名称的列表

to    应该在参数from显示列的视图。这些应该全是TextView。在列表中最初的N视图是从参数from中最初的N列获取的值。

 

  四、公共方法

 

public int getCount ()

获取数据集中记录总行数

 

public View getDropDownView (int position, View convertView, ViewGroup parent)

获得一个在指定位置上显示下拉弹出数据的视图。

参数

position         想得到项目视图的索引

convertView 如果可能旧有的视图重新使用。注解:在使用之前应该检查这个视图不是空的并且类型合适。如果转换视图显示正确的数据是不可能的,这个方法能够创建一个新的视图

parent           视图最终将依附的父对象

返回值

一个对应指定位置的数据的视图。

 

public Filter getFilter ()

返回一个可以通过一种过滤模式来约束数据的过滤器。

这个方法通常被Adapter类实现。

       返回值

一个用于约束数据的过滤器

 

public abstract Object getItem (int position)

获取数据集中指定位置上的数据项目

参数

position adapter中我们想得到项目的位置。

              返回值

指定位置上的数据。

 

public abstract long getItemId (int position)

获取数据集中指定位置上的行ID

参数

position adapter中我们想得到的行ID的项目的位置。

返回值

指定位置上的数据。

 

public abstract View getView (int position, View convertView, ViewGroup parent)

获取一个显示数据集中指定位置数据段视图。可以手动创建视图,或者从XML设计文件填充。当视图从XML设计文件填充时,父视图(如GridViewListView等)将接受默认的设计参数,除非使用inflate(int, android.view.ViewGroup, boolean)去指定一个根视图和防止依附于根视图。

参数

       position 我们想要的在adapter中的数据项目的位置

convertView 如果可能旧有的视图重新使用。注解:在使用之前应该检查这个视图不是空的并且类型合适。如果转换视图显示正确的数据是不可能的,这个方法能够创建一个新的视图

parent    视图最终将依附的父对象。

返回值

一个在指定位置上相应的数据的视图。

 

public SimpleAdapter.ViewBinder getViewBinder ()

返回被用来绑定数据到视图的SimpleAdapter.ViewBinder 

返回值

一个ViewBinder ,如果binder不存在则返回null

参见

setViewBinder(android.widget.SimpleAdapter.ViewBinder)

 

public void setDropDownViewResource (int resource)

设置创建下拉视图的布局资源

参数

       resource       定义下拉视图的布局资源

参见

getDropDownView(int, android.view.View, android.view.ViewGroup)

 

public void setViewBinder (SimpleAdapter.ViewBinder viewBinder)

设置binder用于绑定数据到视图

参数

       viewBinder    用于绑定数据到视图的binder可以设置为null,可用于删除存在的binder

参见

getViewBinder()

 

public void setViewImage (ImageView v, int value)

调用bindView去给ImageView设置图像,但只有当ViewBinder不存在或者如果存在的ViewBinder无法处理绑定到一个ImageView时才调用。如果提供的数据是一个整形时,setViewImage(ImageView, String)方法将被本方法替代

参数
              v     
接收图像的ImageView

value      从数据集获取数据到值

              参见

setViewImage(ImageView, String)

 

public void setViewImage (ImageView v, String value)

调用bindView去给ImageView设置图像,但只有当ViewBinder不存在或者如果存在的ViewBinder无法处理绑定到一个ImageView时才调用。默认的,这个值被作为一个图像资源来对待。如果这个值作为一个图像的Uri来使用。如果提供的数据不是一个整形时,setViewImage(ImageView, int)方法将被本方法替代

参数

       v     接收图像的ImageView

value      从数据集获取数据到值

参见

setViewImage(ImageView, int)

 

public void setViewText (TextView v, String text)

调用bindView去给TextView设置文本,但只有当ViewBinder不存在或者如果存在的ViewBinder无法处理绑定到一个TextView时才调用

参数

       v     将接收文本的TextView

text 被设置到TextView的文本 

 

  五、补充

    文章精选

      简约而不简单——Android SimpleAdapter

      android listview组件之ArrayAdapterSimpleAdapter

      Android用simpleAdapter来直接显示BMP图片(有ViewBinder用法

    示例代码

 

 

private ListView lv;
    
private List<Map<String,String>> data;
    
private SimpleAdapter sAdapter;

lv 
= (ListView)findViewById(R.id.listview);     
data 
= new ArrayList<Map<String, Object>>();
    
for (int i = 0; i < 10; i++) {
            Map
<String, Object> map = new HashMap<String, Object>();
            map.put(
"title""APPLE");
            map.put(
"content""can eat");
map.put(
"check"true);
map.put(
"check1""true");
            map.put(
"image", R.drawable.icon);
            data.add(map);
}
sAdapter 
= new SimpleAdapter(getApplicationContext(), 
                data, 
                R.layout.item, 
        
new String[]{"title","content","check","check1","image"},
        
new int[]{R.id.title,R.id.content,R.id.check,R.id.check1, R.id.image});
lv.setAdapter(sAdapter);


 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582592,如需转载请自行联系原作者

相关文章
|
6月前
|
Android开发
Android 11 修改libcore update-api 遇到的问题
Android 11 修改libcore update-api 遇到的问题
162 1
|
定位技术 API 开发工具
Android 按照步骤接入百度地图API,定位显示不了解决办法
Android 按照步骤接入百度地图API,定位显示不了解决办法
373 1
|
3月前
|
编译器 API Android开发
Android经典实战之Kotlin Multiplatform 中,如何处理不同平台的 API 调用
本文介绍Kotlin Multiplatform (KMP) 中使用 `expect` 和 `actual` 关键字处理多平台API调用的方法。通过共通代码集定义预期API,各平台提供具体实现,编译器确保正确匹配,支持依赖注入、枚举类处理等,实现跨平台代码重用与原生性能。附带示例展示如何定义跨平台函数与类。
95 0
|
5月前
|
API Android开发 开发者
`RecyclerView`是Android API 21引入的UI组件,用于替代ListView和GridView
【6月更文挑战第26天】`RecyclerView`是Android API 21引入的UI组件,用于替代ListView和GridView。它提供高效的数据视图复用,优化的布局管理,支持多种布局(如线性、网格),并解耦数据、适配器和视图。RecyclerView的灵活性、性能(如局部刷新和动画支持)和扩展性使其成为现代Android开发的首选,特别是在处理大规模数据集时。
62 2
|
5月前
|
Java Linux API
微信API:探究Android平台下Hook技术的比较与应用场景分析
微信API:探究Android平台下Hook技术的比较与应用场景分析
|
6月前
|
SQL API Android开发
Android API:Activity.managedQuery()
Android API:Activity.managedQuery()
46 2
|
6月前
|
API 定位技术 开发工具
Android Studio2021.1.1 高德地图api调用这一篇就够了
Android Studio2021.1.1 高德地图api调用这一篇就够了
|
6月前
|
API Android开发
Android Framework增加API 报错 Missing nullability on parameter
Android Framework增加API 报错 Missing nullability on parameter
324 1
|
6月前
|
API Android开发
对于应用研发平台EMAS中安卓 API 32 收不到 FCM 推送的问题
对于应用研发平台EMAS中安卓 API 32 收不到 FCM 推送的问题
106 3
|
API Android开发
mPaaS(移动跨平台框架)目前已经支持了Android API级别21
mPaaS(移动跨平台框架)目前已经支持了Android API级别21
145 2