stanford.androidlib

Class SimpleAdapter

java.lang.Object

android.widget.BaseAdapter

stanford.androidlib.SimpleAdapter

All Implemented Interfaces:

Adapter, ListAdapter, SpinnerAdapter

public abstract class SimpleAdapter
extends BaseAdapter

A simpler version of the Adapter used by ListViews. You can extend this class and override the getView method to customize the way that items in the list should be displayed. You can also call SimpleAdapter.with(this, data, ...) to get an adapter without providing an entire subclass.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SimpleAdapter.ViewProvider Interface for objects that return views for a SimpleAdapter.

Field Summary

Fields inherited from interface android.widget.Adapter

IGNORE_ITEM_VIEW_TYPE, NO_SELECTION

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SimpleAdapter(Context context, Iterable<String> data) Constructs an adapter to hold the given list of items.
protected	SimpleAdapter(Context context, String... data) Constructs an adapter to hold the given array of items.

Method Summary

Modifier and Type	Method and Description
<T extends Context> T	getContext() Returns the Context passed to the constructor.
protected View	getConvertView() Returns the "convert view" passed to getView.
int	getCount() Returns the number of elements in the list passed to the constructor.
String	getItem(int index) Returns the item at the given index as passed to the constructor.
int	getItemCount() Returns the number of items in the adapter.
long	getItemId(int index) Returns a unique ID for the item at the given index, which is just that index itself.
protected View	getParent() Returns the "parent" view passed to getView.
abstract View	getView(int index) In your subclass, you must override this method to return a View that best displays the item of your adapter's list at the given index.
View	getView(int index, View convertView, ViewGroup parent) Builds and returns a View for displaying the item at the given index.
protected void	init(Context context, String... data)
abstract void	setView(int index, View view) Sets the given view to be returned for the item in the list at the given index.
static SimpleAdapter	with(Context context, Iterable<String> data) Returns an adapter that gets its items from the given list and its views from the given view provider.
static SimpleAdapter	with(Context context, Iterable<String> data, SimpleAdapter.ViewProvider provider) Returns an adapter that gets its items from the given list and its views from the given view provider.
static SimpleAdapter	with(Context context, String[] data) Returns an adapter that gets its items from the given array and its views from the given view provider.
static SimpleAdapter	with(Context context, String[] data, SimpleAdapter.ViewProvider provider) Returns an adapter that gets its items from the given array and its views from the given view provider.

Methods inherited from class android.widget.BaseAdapter

areAllItemsEnabled, getDropDownView, getItemViewType, getViewTypeCount, hasStableIds, isEmpty, isEnabled, notifyDataSetChanged, notifyDataSetInvalidated, registerDataSetObserver, unregisterDataSetObserver

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SimpleAdapter

protected SimpleAdapter(Context context,
                        Iterable<String> data)

Constructs an adapter to hold the given list of items.

SimpleAdapter

protected SimpleAdapter(Context context,
                        String... data)

Constructs an adapter to hold the given array of items.

Method Detail

with

public static SimpleAdapter with(Context context,
                                 Iterable<String> data)

Returns an adapter that gets its items from the given list and its views from the given view provider.

with

public static SimpleAdapter with(Context context,
                                 String[] data)

Returns an adapter that gets its items from the given array and its views from the given view provider.

with

public static SimpleAdapter with(Context context,
                                 Iterable<String> data,
                                 SimpleAdapter.ViewProvider provider)

Returns an adapter that gets its items from the given list and its views from the given view provider.

with

public static SimpleAdapter with(Context context,
                                 String[] data,
                                 SimpleAdapter.ViewProvider provider)

Returns an adapter that gets its items from the given array and its views from the given view provider.

init

protected void init(Context context,
                    String... data)

getContext

public final <T extends Context> T getContext()

Returns the Context passed to the constructor.

getConvertView

protected final View getConvertView()

Returns the "convert view" passed to getView. Will be null if getView has never been called.

getCount

public final int getCount()

Returns the number of elements in the list passed to the constructor.

Returns:

getItem

public final String getItem(int index)

Returns the item at the given index as passed to the constructor.

getItemId

public final long getItemId(int index)

Returns a unique ID for the item at the given index, which is just that index itself.

getParent

protected final View getParent()

Returns the "parent" view passed to getView. Will be null if getView has never been called.

getView

public final View getView(int index,
                          View convertView,
                          ViewGroup parent)

Builds and returns a View for displaying the item at the given index. This method simply calls the other simpler overload of getView, which you must override in your SimpleAdapter subclass. If your overload needs the removed parameters "convertView" or "parent", you should call getConvertView or getParent from that method.

getItemCount

public int getItemCount()

Returns the number of items in the adapter.

getView

public abstract View getView(int index)

In your subclass, you must override this method to return a View that best displays the item of your adapter's list at the given index.

setView

public abstract void setView(int index,
                             View view)

Sets the given view to be returned for the item in the list at the given index.