public abstract class

FragmentGridPagerAdapter

extends GridPagerAdapter

Note: The Wearable Support Library classes under the android.support.wearable package are subject to change. For the full Android API reference, see Reference.

java.lang.Object
   ↳ android.support.wearable.view.GridPagerAdapter
     ↳ android.support.wearable.view.FragmentGridPagerAdapter

Class Overview

An implementation of GridPagerAdapter which represents each page as a Fragment.

A minimal implementation needs only the abstract methods: getRowCount(), getColumnCount(int), getFragment(int, int).

If any changes are made to the data, notifyDataSetChanged() must be called to notify the adapter of the change, so it can be reflected in the View.

If pages the data at be inserted or removed, performance can be improved by implementing getFragmentId(int, int) to to provide a stable ID for each item, based on the content.

Summary

[Expand]
Inherited Constants
From class android.support.wearable.view.GridPagerAdapter
[Expand]
Inherited Fields
From class android.support.wearable.view.GridPagerAdapter
Public Constructors
FragmentGridPagerAdapter(FragmentManager fm)
Public Methods
Drawable getBackgroundForPage(int row, int column)
Provides content to be displayed as the background for a specific page.
abstract Fragment getFragment(int row, int column)
Returns the Fragment at the specified row number and column number.
boolean isViewFromObject(View view, Object object)
Determines whether a page View is associated with a specific key object as returned by instantiateItem(ViewGroup, int, int).
Protected Methods
void destroyItem(ViewGroup container, int row, int column, Object object)
Removes a page for the given position.
void finishUpdate(ViewGroup container)
Called when the a change in the shown pages has been completed.
final Drawable getFragmentBackground(int row, int column)
Returns a background for Fragments implementing GridPageOptions.
long getFragmentId(int row, int column)
Returns a unique identifier for the Fragment at the given row/column position.
Fragment instantiateItem(ViewGroup container, int row, int column)
Creates the page for the given position.
[Expand]
Inherited Methods
From class android.support.wearable.view.GridPagerAdapter
From class java.lang.Object

Public Constructors

public FragmentGridPagerAdapter (FragmentManager fm)

Public Methods

public Drawable getBackgroundForPage (int row, int column)

Provides content to be displayed as the background for a specific page.

The return value BACKGROUND_NONE indicates that there is no page-specific background. and the row background should be used (if any).

This implementation simply returns the result of getFragmentBackground(int, int).

Parameters
row the row of the page
column the column of the page
Returns

public abstract Fragment getFragment (int row, int column)

Returns the Fragment at the specified row number and column number.

Fragment instances MAY be stored and reused ONLY if no structural changes are made to the data set or if getFragmentId(int, int) is overridden to provide a stable identifier for each the item at each position, otherwise results are undefined.

Parameters
row the row of the position
column the column of the position

public boolean isViewFromObject (View view, Object object)

Determines whether a page View is associated with a specific key object as returned by instantiateItem(ViewGroup, int, int). This method is required for a PagerAdapter to function properly.

Parameters
view Page View to check for association with object
object Object to check for association with view
Returns
  • true if view is associated with the key object object

Protected Methods

protected void destroyItem (ViewGroup container, int row, int column, Object object)

Removes a page for the given position. The adapter is responsible for removing the view from its container, although it only must ensure this is done by the time it returns from finishUpdate(ViewGroup).

Parameters
container The containing View from which the page will be removed.
row the row to be destroyed
column the column within the row to be destroyed
object The same object that was returned by instantiateItem(ViewGroup, int, int).

protected void finishUpdate (ViewGroup container)

Called when the a change in the shown pages has been completed. At this point you must ensure that all of the pages have actually been added or removed from the container as appropriate.

Parameters
container The containing View which is displaying this adapter's page views

protected final Drawable getFragmentBackground (int row, int column)

Returns a background for Fragments implementing GridPageOptions.

Parameters
row the row of the fragment
column the column of the fragment
Returns

protected long getFragmentId (int row, int column)

Returns a unique identifier for the Fragment at the given row/column position.

The default implementation returns a fixed number based on the position. Subclasses should override this method if the positions of items can change.

Parameters
row the row that this item is at
column the column within this row that the item is at
Returns
  • Unique identifier for the item at position

protected Fragment instantiateItem (ViewGroup container, int row, int column)

Creates the page for the given position. The adapter is responsible for adding the view to the container given here, although it only must ensure this is done by the time it returns from finishUpdate(ViewGroup)

Parameters
container containing View in which the page will be shown
row the row to be instantiated
column the column within the row to be instantiated
Returns
  • a an object representing the new page