FragmentStatePagerAdapter

public abstract class FragmentStatePagerAdapter
extends PagerAdapter

执行PagerAdapter ，使用Fragment来管理每个页面。 该类还处理片段状态的保存和恢复。

当有大量页面时，此版本的寻呼机更有用，工作更像列表视图。 当页面对用户不可见时，它们的整个片段可能被破坏，只保留该片段的保存状态。 这使得寻呼机可以保持与每个访问页面相关的少得多的存储器，与FragmentPagerAdapter相比，在页面之间切换时可能会产生更多开销。

当使用FragmentPagerAdapter时，主机ViewPager必须有一个有效的ID集。

子类只需要实现 getItem(int)和 getCount()以具有工作适配器。

以下是包含列表片段的寻呼机的示例实现：

public class FragmentStatePagerSupport extends Activity {
    static final int NUM_ITEMS = 10;

    MyAdapter mAdapter;

    ViewPager mPager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.fragment_pager);

        mAdapter = new MyAdapter(getFragmentManager());

        mPager = (ViewPager)findViewById(R.id.pager);
        mPager.setAdapter(mAdapter);

        // Watch for button clicks.
        Button button = (Button)findViewById(R.id.goto_first);
        button.setOnClickListener(new OnClickListener() {
            public void onClick(View v) {
                mPager.setCurrentItem(0);
            }
        });
        button = (Button)findViewById(R.id.goto_last);
        button.setOnClickListener(new OnClickListener() {
            public void onClick(View v) {
                mPager.setCurrentItem(NUM_ITEMS-1);
            }
        });
    }

    public static class MyAdapter extends FragmentStatePagerAdapter {
        public MyAdapter(FragmentManager fm) {
            super(fm);
        }

        @Override
        public int getCount() {
            return NUM_ITEMS;
        }

        @Override
        public Fragment getItem(int position) {
            return ArrayListFragment.newInstance(position);
        }
    }

    public static class ArrayListFragment extends ListFragment {
        int mNum;

        /**
         * Create a new instance of CountingFragment, providing "num"
         * as an argument.
         */
        static ArrayListFragment newInstance(int num) {
            ArrayListFragment f = new ArrayListFragment();

            // Supply num input as an argument.
            Bundle args = new Bundle();
            args.putInt("num", num);
            f.setArguments(args);

            return f;
        }

        /**
         * When creating, retrieve this instance's number from its arguments.
         */
        @Override
        public void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            mNum = getArguments() != null ? getArguments().getInt("num") : 1;
        }

        /**
         * The Fragment's UI is just a simple text view showing its
         * instance number.
         */
        @Override
        public View onCreateView(LayoutInflater inflater, ViewGroup container,
                Bundle savedInstanceState) {
            View v = inflater.inflate(R.layout.fragment_pager_list, container, false);
            View tv = v.findViewById(R.id.text);
            ((TextView)tv).setText("Fragment #" + mNum);
            return v;
        }

        @Override
        public void onActivityCreated(Bundle savedInstanceState) {
            super.onActivityCreated(savedInstanceState);
            setListAdapter(new ArrayAdapter<String>(getActivity(),
                    android.R.layout.simple_list_item_1, Cheeses.sCheeseStrings));
        }

        @Override
        public void onListItemClick(ListView l, View v, int position, long id) {
            Log.i("FragmentList", "Item clicked: " + id);
        }
    }
}

顶级片段的 R.layout.fragment_pager资源是：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:orientation="vertical" android:padding="4dip"
        android:gravity="center_horizontal"
        android:layout_width="match_parent" android:layout_height="match_parent">

    <android.support.v4.view.ViewPager
            android:id="@+id/pager"
            android:layout_width="match_parent"
            android:layout_height="0px"
            android:layout_weight="1">
    </android.support.v4.view.ViewPager>

    <LinearLayout android:orientation="horizontal"
            android:gravity="center" android:measureWithLargestChild="true"
            android:layout_width="match_parent" android:layout_height="wrap_content"
            android:layout_weight="0">
        <Button android:id="@+id/goto_first"
            android:layout_width="wrap_content" android:layout_height="wrap_content"
            android:text="@string/first">
        </Button>
        <Button android:id="@+id/goto_last"
            android:layout_width="wrap_content" android:layout_height="wrap_content"
            android:text="@string/last">
        </Button>
    </LinearLayout>
</LinearLayout>

包含每个单独片段布局的 R.layout.fragment_pager_list资源是：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:drawable/gallery_thumb">

    <TextView android:id="@+id/text"
        android:layout_width="match_parent" android:layout_height="wrap_content"
        android:gravity="center_vertical|center_horizontal"
        android:textAppearance="?android:attr/textAppearanceMedium"
        android:text="@string/hello_world"/>

    <!-- The frame layout is here since we will be showing either
    the empty view or the list view.  -->
    <FrameLayout
        android:layout_width="match_parent"
        android:layout_height="0dip"
        android:layout_weight="1" >
        <!-- Here is the list. Since we are using a ListActivity, we
             have to call it "@android:id/list" so ListActivity will
             find it -->
        <ListView android:id="@android:id/list"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:drawSelectorOnTop="false"/>

        <!-- Here is the view to show if the list is emtpy -->
        <TextView android:id="@android:id/empty"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:textAppearance="?android:attr/textAppearanceMedium"
            android:text="No items."/>

    </FrameLayout>

</LinearLayout>

摘要(Summary)

Inherited constants
From class android.support.v4.view.PagerAdapter int POSITION_NONE int POSITION_UNCHANGED

继承方法(Inherited methods)
From class android.support.v4.view.PagerAdapter void destroyItem(View container, int position, Object object) 此方法已弃用。 使用destroyItem(ViewGroup, int, Object) void destroyItem(ViewGroup container, int position, Object object) 删除给定位置的页面。 void finishUpdate(View container) 此方法已弃用。 使用finishUpdate(ViewGroup) void finishUpdate(ViewGroup container) 在所示页面中的更改完成时调用。 abstract int getCount() 返回可用的视图数量。 int getItemPosition(Object object) 当主视图试图确定某个项目的位置是否已更改时调用。 CharSequence getPageTitle(int position) 这个方法可以被ViewPager调用来获得一个标题字符串来描述指定的页面。 float getPageWidth(int position) 以（0.f-1.f）的ViewPager测量宽度的百分比形式返回给定页面的比例宽度。 Object instantiateItem(ViewGroup container, int position) 创建给定位置的页面。 Object instantiateItem(View container, int position) 此方法已弃用。 使用instantiateItem(ViewGroup, int) abstract boolean isViewFromObject(View view, Object object) 确定页面视图是否与 instantiateItem(ViewGroup, int)返回的特定键对象相关联。 void notifyDataSetChanged() 如果支持此适配器的数据发生更改并且关联的视图应该更新，应该由应用程序调用此方法。 void registerDataSetObserver(DataSetObserver observer) 注册观察者以接收与适配器数据更改有关的回调。 void restoreState(Parcelable state, ClassLoader loader) 还原与此适配器及其先前由 saveState()保存的页面关联的任何实例状态。 Parcelable saveState() 如果需要重建当前UI状态，请保存与此适配器及其应恢复的页面关联的任何实例状态。 void setPrimaryItem(ViewGroup container, int position, Object object) 被调用以通知适配器当前哪个项目被认为是“主要”，这是向用户显示的当前页面。 void setPrimaryItem(View container, int position, Object object) 此方法已弃用。 使用setPrimaryItem(ViewGroup, int, Object) void startUpdate(ViewGroup container) 当所显示页面的变化即将开始时调用。 void startUpdate(View container) 此方法已弃用。 使用startUpdate(ViewGroup) void unregisterDataSetObserver(DataSetObserver observer) 从与适配器数据更改相关的回调中注销观察者。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过了一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public constructors

FragmentStatePagerAdapter (FragmentManager fm)

公共方法(Public methods)

void destroyItem (ViewGroup container, 
                int position, 
                Object object)

void finishUpdate (ViewGroup container)

Fragment getItem (int position)

Object instantiateItem (ViewGroup container, 
                int position)

boolean isViewFromObject (View view, 
                Object object)

void restoreState (Parcelable state, 
                ClassLoader loader)

Parcelable saveState ()

void setPrimaryItem (ViewGroup container, 
                int position, 
                Object object)

void startUpdate (ViewGroup container)