public class

ListView

extends ListView
java.lang.Object
   ↳ android.view.View
     ↳ android.view.ViewGroup
       ↳ android.widget.AdapterView<T extends android.widget.Adapter>
         ↳ android.widget.AbsListView
           ↳ android.widget.ListView
             ↳ sofia.widget.ListView<E>

Class Overview

A subclass of android.widget.ListView that is easier to use. It provides methods like those in the List interface (add, remove, get, and set, among others) to manipulate the contents of the list, as well as an accessor method getList() that returns a List that automatically refreshes the list view when its structure is changed.

Summary

[Expand]
Inherited Constants
From class android.widget.ListView
From class android.widget.AbsListView
From class android.widget.AdapterView
From class android.view.ViewGroup
From class android.view.View
[Expand]
Inherited Fields
From class android.view.View
Public Constructors
ListView(Context context)
Creates a new ListView.
ListView(Context context, AttributeSet attrs)
Creates a new ListView.
ListView(Context context, AttributeSet attrs, int defStyle)
Creates a new ListView.
Public Methods
void add(int index, E item)
Inserts an item into the list view at the specified index.
boolean add(E item)
Adds an item to the list view.
boolean addAll(int index, Collection<? extends E> collection)
Inserts the items in the specified collection into the list view at the specified index.
boolean addAll(Collection<? extends E> collection)
Adds the items in the specified collection to the list view.
void clear()
Removes all items from the list view.
E get(int index)
Gets the element at the specified index from the list view.
List<E> getList()
Gets the list of items that is managed by this list view.
E getSelectedItem()
Gets the currently selected item in the list view.
void refresh()
Refreshes the list view to update its contents from the list it manages.
E remove(int index)
Removes the item at the specified index from the list view.
boolean remove(E item)
Removes the specified item from the list view.
E set(int index, E item)
Replaces the element at the specified index from the list view with another item.
[Expand]
Inherited Methods
From class android.widget.ListView
From class android.widget.AbsListView
From class android.widget.AdapterView
From class android.view.ViewGroup
From class android.view.View
From class java.lang.Object
From interface android.graphics.drawable.Drawable.Callback
From interface android.text.TextWatcher
From interface android.view.KeyEvent.Callback
From interface android.view.ViewManager
From interface android.view.ViewParent
From interface android.view.ViewTreeObserver.OnGlobalLayoutListener
From interface android.view.ViewTreeObserver.OnTouchModeChangeListener
From interface android.view.accessibility.AccessibilityEventSource
From interface android.widget.Filter.FilterListener

Public Constructors

public ListView (Context context)

Creates a new ListView.

Parameters
context the context

public ListView (Context context, AttributeSet attrs)

Creates a new ListView.

Parameters
context the context
attrs the attribute set from the layout XML file

public ListView (Context context, AttributeSet attrs, int defStyle)

Creates a new ListView.

Parameters
context the context
attrs the attribute set from the layout XML file
defStyle the default style ID

Public Methods

public void add (int index, E item)

Inserts an item into the list view at the specified index.

Parameters
index the index where the new item should be inserted
item the item to add to the list view

public boolean add (E item)

Adds an item to the list view.

Parameters
item the item to add to the list view
Returns
  • true if the item could be added, or false if it could not

public boolean addAll (int index, Collection<? extends E> collection)

Inserts the items in the specified collection into the list view at the specified index.

Parameters
index the index where the new items should be inserted
collection the items to add to the list view
Returns
  • true if the items could be added, or false if they could not

public boolean addAll (Collection<? extends E> collection)

Adds the items in the specified collection to the list view.

Parameters
collection the items to add to the list view
Returns
  • rue if the items could be added, or false if they could not

public void clear ()

Removes all items from the list view.

public E get (int index)

Gets the element at the specified index from the list view.

Parameters
index the index of the item to retrieve
Returns
  • the item at the specified index

public List<E> getList ()

Gets the list of items that is managed by this list view. Changes made to the structure of the list returned by this method (that is, adding, removing, or replacing items) will be immediately reflected in the list view. You only need to explicitly refresh() the list if you make a change to an element inside the list without directly modifying the list itself.

Returns
  • the List of items managed by this list view

public E getSelectedItem ()

Gets the currently selected item in the list view.

Returns
  • the currently selected item in the list view, or null if there is no item selected

public void refresh ()

Refreshes the list view to update its contents from the list it manages. This method does not need to be called after methods like add or remove -- it only needs to be called if you change a property of one of the elements in the list (for example, by calling a setter) without modifying the structure of the list itself.

public E remove (int index)

Removes the item at the specified index from the list view.

Parameters
index the index of the item to be removed
Returns
  • the item that was removed

public boolean remove (E item)

Removes the specified item from the list view.

Parameters
item the item to remove from the list view
Returns
  • true if the item was found and removed, or false if it was not

public E set (int index, E item)

Replaces the element at the specified index from the list view with another item.

Parameters
index the index of the item to retrieve
item the item to put into the list
Returns
  • the item previously at the specified index