AdapterView

版本：Android 2.3 r1

结构

继承关系

public abstract classAdapterView extendsViewGroup

java.lang.Object

android.view.View

android.view.ViewGroup

android.widget.AdapterView

子类及间接子类

直接子类

AbsListView, AbsSpinner

间接子类

ExpandableListView, Gallery, GridView, ListView, Spinner

类概述

AdapterView是内容由Adapter来决定的视图类。

参见ListView、GridView、Spinner和Gallery等常见子类。

常量

public static final int INVALID_POSITION

代表无效的位置。有效值的范围是0到当前适配器项目数减1。

常量值：-1 (0xffffffff)

public static final long INVALID_ROW_ID

代表空或者无效的行ID。

常量值：-9223372036854775808 (0x8000000000000000)

public static final int ITEM_VIEW_TYPE_HEADER_OR_FOOTER

当条项是列表头或列表尾时，调用getItemViewType(int)函数的返回值。

常量值：-2 (0xfffffffe)

public static final int ITEM_VIEW_TYPE_IGNORE

当适配器禁止条项的视图再利用时，调用getItemViewType(int)函数的返回值。

常量值：-1 (0xffffffff)

公有构造函数

publicAdapterView(Context context)

构造函数

publicAdapterView(Context context, AttributeSet attrs)

构造函数

publicAdapterView(Context context, AttributeSet attrs, int defStyle)

构造函数

公有方法

public voidaddView(View child)

该类不支持该方法，如果调用将抛出UnsupportedOperationException异常。

参数

child忽略

抛出

UnsupportedOperationException调用该方法时

public voidaddView(View child, int index)

该类不支持该方法，如果调用将抛出UnsupportedOperationException异常。

参数

child忽略。

index忽略。

抛出

UnsupportedOperationException调用该方法时

public voidaddView(View child, int index, ViewGroup.LayoutParams params)

该类不支持该方法，如果调用将抛出UnsupportedOperationException异常。

参数

child忽略。

index忽略。

params忽略。

抛出

UnsupportedOperationException调用该方法时

public voidaddView(View child, ViewGroup.LayoutParams params)

该类不支持该方法，如果调用将抛出UnsupportedOperationException异常。

参数

child忽略。

params忽略。

抛出

UnsupportedOperationException调用该方法时

public booleandispatchPopulateAccessibilityEvent(AccessibilityEvent event)

分发AccessibilityEvent事件到该视图的子视图中。

参数

event事件。

返回值

如果事件分发完成，返回真。

public abstract TgetAdapter()

返回当前与该小部件关联的适配器。

返回值

用于提供视图内容的适配器。

public intgetCount()

返回值

与AdapterView相关联的适配器的条目数量。（该值是数据条目的数量，可能大于可见的视图的数量。）

public ViewgetEmptyView()

当前适配器无内容时，AdapterView会显示特殊的空视图。 空视图用于告诉用户，该AdapterView没有数据。

返回值

适配器为空时显示的视图。

public intgetFirstVisiblePosition()

返回显示在屏幕上的第一个元素在适配器中所处的位置。

返回值

在适配器数据集中的位置。

public ObjectgetItemAtPosition(int position)

取得列表中指定位置的数据。

参数

position要取得数据的位置。

返回值

列表中指定位置的数据。

public longgetItemIdAtPosition(int position)

(译者注：关于此方法的分析，参见这里。)

public intgetLastVisiblePosition()

返回显示在屏幕上的最后一个元素在适配器中所处的位置。

返回值

在适配器数据集中的位置。

public final AdapterView.OnItemClickListenergetOnItemClickListener()

返回值

点击AdapterView中的条目时执行的回调函数；没有设置时返回空。

public final AdapterView.OnItemLongClickListenergetOnItemLongClickListener()

返回值

取得长按AdapterView中的条目时执行的回调函数的监听器；未设置则返回空。

public final AdapterView.OnItemSelectedListenergetOnItemSelectedListener()

public intgetPositionForView(View view)

取得适配器项目对应的视图或其子视图在适配器的数据中所处的位置。

参数

view适配器条目或其后代的视图。调用时该项目在AdapterView中必须可见。

返回值

视图在适配器数据集中的位置；如果视图不在数据列表中或当前不可见，则返回INVALID_POSITION。

public ObjectgetSelectedItem()

返回值

当前选中条目对应的数据；无选中条目时返回空。

public longgetSelectedItemId()

返回值

当前选中条目相应的ID；无选中条目则返回INVALID_ROW_ID。

public intgetSelectedItemPosition()

返回当前选中项目在适配器数据中的位置。

返回值

返回从零开始的位置（索引）信息，没有选择条目时返回INVALID_POSITION。

public abstract ViewgetSelectedView()

返回值

当前选中条目对应的视图；无选中条目时返回空。

public booleanperformItemClick(View view, int position, long id)

如果定义了OnItemClickListener则调用它。

参数

view AdapterView中被点击的视图。

position视图在适配器中的索引。

id点击的条目的行ID。

返回值

如果成功调用了定义的OnItemClickListener则返回真；否则返回假。

public voidremoveAllViews()

该类不支持该方法，如果调用将抛出UnsupportedOperationException异常。

抛出

UnsupportedOperationException调用该方法时

public voidremoveView(View child)

该类不支持该方法，如果调用将抛出UnsupportedOperationException异常。

参数

child忽略。

抛出

UnsupportedOperationException调用该方法时

public voidremoveViewAt(int index)

该类不支持该方法，如果调用将抛出UnsupportedOperationException异常。

参数

index忽略。

抛出

UnsupportedOperationException调用该方法时

public abstract voidsetAdapter(T adapter)

设置用于为该小部件的视图提供用于显示的数据的适配器。

参数

adapter用于创建视图内容的适配器。

public voidsetEmptyView(View emptyView)

设置适配器内容为空时显示的视图。

public voidsetFocusable(boolean focusable)

设置该视图是否可以获取焦点。 设为假时，可以确保在触控模式中该视图不能得到焦点。

参数

focusable设为真时，该视图可以得到焦点。

public voidsetFocusableInTouchMode(boolean focusable)

设置在触控模式下该视图是否可以获取焦点。设为真时，可以保证视图可以得到焦点。

参数

focusable设为真时，该视图在触控模式下可以得到焦点。

public voidsetOnClickListener(View.OnClickListener l)

注册点击该视图时执行的回调函数。如果该视图不可点击，会将其改为可以点击的状态。

参数

l事件发生时运行的回调函数。

public voidsetOnItemClickListener(AdapterView.OnItemClickListener listener)

注册单击AdapterView中的条目时执行的回调函数。

参数

listener将要调用的回调。

public voidsetOnItemLongClickListener(AdapterView.OnItemLongClickListener listener)

注册长按AdapterView中的条目时执行的回调函数。

参数

listener事件发生时运行的回调函数。

public voidsetOnItemSelectedListener(AdapterView.OnItemSelectedListener listener)

注册选中AdapterView中的条目时执行的回调函数。

参数

listener事件发生时运行的回调函数。

public abstract voidsetSelection(int position)

设置当前选择条目。为了支持无障碍功能，重写该方法的子类必须首先调用父类的该方法。

参数

position选择的数据条目的索引（从零开始）。

保护方法

protected booleancanAnimate()

指示视图组是否能够在首次布局后为其子视图提供动画效果的显示。

返回值

如果子视图可以使用动画效果则返回真，否则返回假。

protected voiddispatchRestoreInstanceState(SparseArray container)

为了防止适配器生成的视图被解冻而重写。

参数

container保存有之前存储的状态信息的SparseArray。

protected voiddispatchSaveInstanceState(SparseArray container)

为了防止适配器生成的视图被冻结而重写。

参数

container保存视图状态的SparseArray。

protected voidonLayout(boolean changed, int left, int top, int right, int bottom)

该视图设置其子视图的大小及位置时调用。派生类可以重写此方法，并为其子类布局。

参数

changed是否为视图设置了新的大小和位置。

left相对于父视图的左侧的位置。

top相对于父视图的顶部的位置。

right相对于父视图的右侧的位置。

bottom相对于父视图的底部的位置。

补充

补充说明

本文由Android中文在线文档转换而成。

文章精选

小胖's blog

Android SDK中文文档计划(14)使用AdapterView来绑定数据