public
static
interface
RemoteViewsService.RemoteViewsFactory
| android.widget.RemoteViewsService.RemoteViewsFactory |
An interface for an adapter between a remote collection view (ListView, GridView, etc) and
the underlying data for that view. The implementor is responsible for making a RemoteView
for each item in the data set. This interface is a thin wrapper around Adapter.
See also:
Public methods | |
|---|---|
abstract
int
|
getCount()
See |
abstract
long
|
getItemId(int position)
See |
abstract
RemoteViews
|
getLoadingView()
This allows for the use of a custom loading view which appears between the time that
|
abstract
RemoteViews
|
getViewAt(int position)
See |
abstract
int
|
getViewTypeCount()
See |
abstract
boolean
|
hasStableIds()
See |
abstract
void
|
onCreate()
Called when your factory is first constructed. |
abstract
void
|
onDataSetChanged()
Called when notifyDataSetChanged() is triggered on the remote adapter. |
abstract
void
|
onDestroy()
Called when the last RemoteViewsAdapter that is associated with this factory is unbound. |
long getItemId (int position)
See getItemId(int).
| Parameters | |
|---|---|
position |
int:
The position of the item within the data set whose row id we want. |
| Returns | |
|---|---|
long |
The id of the item at the specified position. |
RemoteViews getLoadingView ()
This allows for the use of a custom loading view which appears between the time that
getViewAt(int) is called and returns. If null is returned, a default loading
view will be used.
| Returns | |
|---|---|
RemoteViews |
The RemoteViews representing the desired loading view. |
RemoteViews getViewAt (int position)
See getView(int, android.view.View, android.view.ViewGroup).
Note: expensive tasks can be safely performed synchronously within this method, and a
loading view will be displayed in the interim. See getLoadingView().
| Parameters | |
|---|---|
position |
int:
The position of the item within the Factory's data set of the item whose
view we want. |
| Returns | |
|---|---|
RemoteViews |
A RemoteViews object corresponding to the data at the specified position. |
int getViewTypeCount ()
See getViewTypeCount().
| Returns | |
|---|---|
int |
The number of types of Views that will be returned by this factory. |
boolean hasStableIds ()
See hasStableIds().
| Returns | |
|---|---|
boolean |
True if the same id always refers to the same object. |
void onCreate ()
Called when your factory is first constructed. The same factory may be shared across multiple RemoteViewAdapters depending on the intent passed.
void onDataSetChanged ()
Called when notifyDataSetChanged() is triggered on the remote adapter. This allows a RemoteViewsFactory to respond to data changes by updating any internal references. Note: expensive tasks can be safely performed synchronously within this method. In the interim, the old data will be displayed within the widget.
void onDestroy ()
Called when the last RemoteViewsAdapter that is associated with this factory is unbound.
Developers