public class ListFragment
extends Fragment
java.lang.Object | ||
↳ | android.support.v4.app.Fragment | |
↳ | android.support.v4.app.ListFragment |
静态库支持版本的框架ListFragment
。 用于编写在Android 3.0之前的平台上运行的应用程序。 在Android 3.0或更高版本上运行时,此实现仍在使用; 它不会尝试切换到框架的实现。 请参阅框架SDK文档以了解类概述。
Public constructors |
|
---|---|
ListFragment() |
Public methods |
|
---|---|
ListAdapter |
getListAdapter() 获取与此片段的ListView关联的ListAdapter。 |
ListView |
getListView() 获取片段的列表视图控件。 |
long |
getSelectedItemId() 获取当前选定列表项的光标行ID。 |
int |
getSelectedItemPosition() 获取当前选定列表项的位置。 |
View |
onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) 提供默认实现来返回一个简单的列表视图。 |
void |
onDestroyView() 从列表视图中分离。 |
void |
onListItemClick(ListView l, View v, int position, long id) 当选择列表中的项目时,将调用此方法。 |
void |
onViewCreated(View view, Bundle savedInstanceState) 一旦创建了视图层次结构,附加到列表视图。 |
void |
setEmptyText(CharSequence text) ListFragment的默认内容有一个TextView,当列表为空时可以显示该内容。 |
void |
setListAdapter(ListAdapter adapter) 为列表视图提供光标。 |
void |
setListShown(boolean shown) 控制列表是否正在显示。 |
void |
setListShownNoAnimation(boolean shown) 像 |
void |
setSelection(int position) 使用适配器的数据将当前选定的列表项目设置到指定的位置 |
Inherited methods |
|
---|---|
From class android.support.v4.app.Fragment
|
|
From class java.lang.Object
|
|
From interface android.content.ComponentCallbacks
|
|
From interface android.view.View.OnCreateContextMenuListener
|
ListFragment ()
long getSelectedItemId ()
获取当前选定列表项的光标行ID。
Returns | |
---|---|
long |
int getSelectedItemPosition ()
获取当前选定列表项的位置。
Returns | |
---|---|
int |
View onCreateView (LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
提供默认实现来返回一个简单的列表视图。 子类可以覆盖以替换它们自己的布局。 如果这样做,返回的视图层次结构必须具有一个ListView,其ID为android.R.id.list
并且可以有一个兄弟视图ID为android.R.id.empty
,该列表为空时将显示该视图。
如果您用自己的自定义内容覆盖此方法,请考虑在布局文件中包含标准布局list_content
,以便继续保留ListFragment的所有标准行为。 特别是,这是目前唯一能够显示内置的不确定进度状态的方法。
Parameters | |
---|---|
inflater |
LayoutInflater : The LayoutInflater object that can be used to inflate any views in the fragment, |
container |
ViewGroup : If non-null, this is the parent view that the fragment's UI should be attached to. The fragment should not add the view itself, but this can be used to generate the LayoutParams of the view. |
savedInstanceState |
Bundle : If non-null, this fragment is being re-constructed from a previous saved state as given here. |
Returns | |
---|---|
View |
Return the View for the fragment's UI, or null. |
void onDestroyView ()
从列表视图中分离。
void onListItemClick (ListView l, View v, int position, long id)
当选择列表中的项目时,将调用此方法。 子类应该重写。 如果子类需要访问与选定项相关的数据,它们可以调用getListView()。getItemAtPosition(position)。
Parameters | |
---|---|
l |
ListView : The ListView where the click happened |
v |
View : The view that was clicked within the ListView |
position |
int : The position of the view in the list |
id |
long : The row id of the item that was clicked |
void onViewCreated (View view, Bundle savedInstanceState)
一旦创建了视图层次结构,附加到列表视图。
Parameters | |
---|---|
view |
View : The View returned by onCreateView(LayoutInflater, ViewGroup, Bundle) . |
savedInstanceState |
Bundle : If non-null, this fragment is being re-constructed from a previous saved state as given here. |
void setEmptyText (CharSequence text)
ListFragment的默认内容有一个TextView,当列表为空时可以显示该内容。 如果您想显示它,请调用此方法提供应该使用的文本。
Parameters | |
---|---|
text |
CharSequence
|
void setListShown (boolean shown)
控制列表是否正在显示。 如果您正在等待显示初始数据,则可以使其不显示。 在此期间,将显示一个不确定的进度指示器。
应用程序通常不需要使用它自己。 ListFragment的默认行为是从列表不显示开始,只有在setListAdapter(ListAdapter)
给出适配器时才显示它。 如果该点上的列表没有被显示,那么当它被显示时,将不会看到隐藏状态。
Parameters | |
---|---|
shown |
boolean : If true, the list view is shown; if false, the progress indicator. The initial value is true. |
void setListShownNoAnimation (boolean shown)
像 setListShown(boolean)
一样,但从以前的状态转换时不使用动画。
Parameters | |
---|---|
shown |
boolean
|
void setSelection (int position)
使用适配器的数据将当前选定的列表项目设置到指定的位置