FileDocCategorySizeDatePackage
FragmentPagerAdapter.javaAPI DocAndroid 5.1 API6204Thu Mar 12 22:22:56 GMT 2015android.support.v4.app

FragmentPagerAdapter

public abstract class FragmentPagerAdapter extends android.support.v4.view.PagerAdapter
Implementation of {@link android.support.v4.view.PagerAdapter} that represents each page as a {@link Fragment} that is persistently kept in the fragment manager as long as the user can return to the page.

This version of the pager is best for use when there are a handful of typically more static fragments to be paged through, such as a set of tabs. The fragment of each page the user visits will be kept in memory, though its view hierarchy may be destroyed when not visible. This can result in using a significant amount of memory since fragment instances can hold on to an arbitrary amount of state. For larger sets of pages, consider {@link FragmentStatePagerAdapter}.

When using FragmentPagerAdapter the host ViewPager must have a valid ID set.

Subclasses only need to implement {@link #getItem(int)} and {@link #getCount()} to have a working adapter.

Here is an example implementation of a pager containing fragments of lists: {@sample development/samples/Support4Demos/src/com/example/android/supportv4/app/FragmentPagerSupport.java complete}

The R.layout.fragment_pager resource of the top-level fragment is: {@sample development/samples/Support4Demos/res/layout/fragment_pager.xml complete}

The R.layout.fragment_pager_list resource containing each individual fragment's layout is: {@sample development/samples/Support4Demos/res/layout/fragment_pager_list.xml complete}

Fields Summary
private static final String
TAG
private static final boolean
DEBUG
private final FragmentManager
mFragmentManager
private FragmentTransaction
mCurTransaction
private Fragment
mCurrentPrimaryItem
Constructors Summary
public FragmentPagerAdapter(FragmentManager fm)


       
        mFragmentManager = fm;
    
Methods Summary
public voiddestroyItem(android.view.ViewGroup container, int position, java.lang.Object object)

        if (mCurTransaction == null) {
            mCurTransaction = mFragmentManager.beginTransaction();
        }
        if (DEBUG) Log.v(TAG, "Detaching item #" + getItemId(position) + ": f=" + object
                + " v=" + ((Fragment)object).getView());
        mCurTransaction.detach((Fragment)object);
    
public voidfinishUpdate(android.view.ViewGroup container)

        if (mCurTransaction != null) {
            mCurTransaction.commitAllowingStateLoss();
            mCurTransaction = null;
            mFragmentManager.executePendingTransactions();
        }
    
public abstract FragmentgetItem(int position)
Return the Fragment associated with a specified position.

public longgetItemId(int position)
Return a unique identifier for the item at the given position.

The default implementation returns the given position. Subclasses should override this method if the positions of items can change.

param
position Position within this adapter
return
Unique identifier for the item at position

        return position;
    
public java.lang.ObjectinstantiateItem(android.view.ViewGroup container, int position)

        if (mCurTransaction == null) {
            mCurTransaction = mFragmentManager.beginTransaction();
        }

        final long itemId = getItemId(position);

        // Do we already have this fragment?
        String name = makeFragmentName(container.getId(), itemId);
        Fragment fragment = mFragmentManager.findFragmentByTag(name);
        if (fragment != null) {
            if (DEBUG) Log.v(TAG, "Attaching item #" + itemId + ": f=" + fragment);
            mCurTransaction.attach(fragment);
        } else {
            fragment = getItem(position);
            if (DEBUG) Log.v(TAG, "Adding item #" + itemId + ": f=" + fragment);
            mCurTransaction.add(container.getId(), fragment,
                    makeFragmentName(container.getId(), itemId));
        }
        if (fragment != mCurrentPrimaryItem) {
            fragment.setMenuVisibility(false);
            fragment.setUserVisibleHint(false);
        }

        return fragment;
    
public booleanisViewFromObject(android.view.View view, java.lang.Object object)

        return ((Fragment)object).getView() == view;
    
private static java.lang.StringmakeFragmentName(int viewId, long id)

        return "android:switcher:" + viewId + ":" + id;
    
public voidrestoreState(android.os.Parcelable state, java.lang.ClassLoader loader)

    
public android.os.ParcelablesaveState()

        return null;
    
public voidsetPrimaryItem(android.view.ViewGroup container, int position, java.lang.Object object)

        Fragment fragment = (Fragment)object;
        if (fragment != mCurrentPrimaryItem) {
            if (mCurrentPrimaryItem != null) {
                mCurrentPrimaryItem.setMenuVisibility(false);
                mCurrentPrimaryItem.setUserVisibleHint(false);
            }
            if (fragment != null) {
                fragment.setMenuVisibility(true);
                fragment.setUserVisibleHint(true);
            }
            mCurrentPrimaryItem = fragment;
        }
    
public voidstartUpdate(android.view.ViewGroup container)