ViewPager用于实现页面间的切换。
ViewPager中的主要方法详解
(1) setAdapter(PagerAdapter adapter)
该方法为ViewPager设置适配器。
(2)setCurrentItem(int item)
该方法设置当前显示的界面,是哪一个item,item从0开始编号。
(3)addOnPageChangeListener(OnPageChangeListener listener);
该方法为ViewPager添加页面切换时的监听,当前显示页面被改变时,该方法会被调用。
(4) setOnScrollChangeListener(OnScrollChangeListener l)
该方法为ViewPager增加滚动状态监听,但该方法需要minSdkVersion为23,在手指拖动页面切换的过程中,该方法一直在被调用。
OnPageChangeListener中的三个方法详解
onPageScrollStateChanged(int state)
该方法在手指操作屏幕的时候发生变化。有三个值:0(END),1(PRESS) ,2(UP) 。当用手指滑动翻页时,手指按下去的时候会触发这个方法,state值为1,手指抬起时,如果发生了滑动(即使很小),这个值会变为2,然后最后变为0 。
总共执行这个方法三次。一种特殊情况是手指按下去以后一点滑动也没有发生,这个时候只会调用这个方法两次,state值分别是1,0 。当setCurrentItem翻页时,会执行这个方法两次,state值分别为2 ,0 。
onPageScrolled(int position, float positionOffset, int positionOffsetPixels) 该方法在滑动过程中将一直被调用,该方法的参数说明如下:
position:当用手指滑动时,如果手指按在页面上不动,position和当前页面index是一致的;如果手指向左拖动(相应页面向右翻动),这时候position大部分时间和当前页面是一致的,只有翻页成功的情况下最后一次调用才会变为目标页面;如果手指向右拖动(相应页面向左翻动),这时候position大部分时间和目标页面是一致的,只有翻页不成功的情况下最后一次调用才会变为原页面。当直接设置setCurrentItem翻页时,如果是相邻的情况(比如现在是第二个页面,跳到第一或者第三个页面),如果页面向右翻动,大部分时间是和当前页面是一致的,只有最后才变成目标页面;如果向左翻动,position和目标页面是一致的。这和用手指拖动页面翻动是基本一致的。如果不是相邻的情况,比如我从第一个页面跳到第三个页面,position先是0,然后逐步变成1,然后逐步变成2;我从第三个页面跳到第一个页面,position先是1,然后逐步变成0,并没有出现为2的情况。
positionOffset:当前页面滑动比例,如果页面向右翻动,这个值不断变大,最后在趋近1的情况后突变为0。如果页面向左翻动,这个值不断变小,最后变为0。
positionOffsetPixels:当前页面滑动像素,变化情况和positionOffset一致onPageSelected(int position) position是被选中页面的索引,该方法在页面被选中或页面滑动足够距离切换到该页手指抬起时调用。
三个方法的执行顺序:初始化的时候首先是onPageSelected,用手指拖动翻页时,最先执行一遍
onPageScrollStateChanged(1),然后不断执行onPageScrolled,放手指的时候,直接立即onPageScrollStateChanged(2),然后立即执行一次onPageSelected,然后再不断执行onPageScrollStateChanged,最后执行一次onPageScrollStateChanged(0);
三种适配器的名字
PagerAdapter
主要方法详解
public abstract int getCount ()
返回有效视图的数量。public int getItemPosition (Object object)
当宿主视图尝试判断一项的位置是否改变时调用。如果给定项的位置没有改变则返回POSITION_UNCHANGED
,如果该项不再存在于适配器中则返回POSITION_NONE
。
在ViewPager.dataSetChanged()中将对该函数的返回值进行判断,如果返回POSITION_NONE
则调用destroyItem(ViewGroup container, int position, Object object)
方法将该视图销毁,如果返回POSITION_UNCHANGED
则不做任何改变,如果数据改变,则触发PagerAdapter.instantiateItem(ViewGroup container, int position)
方法改变视图。
PagerAdapter中该方法的默认返回值是 POSITION_UNCHANGED。如果没有重载该函数,而导致调用PagerAdapter.notifyDataSetChanged() 后,什么都没有发生。public boolean isViewFromObject (View view, Object object)
决定一个页面view是否与instantiateItem(ViewGroup, int)
方法返回的具体key对象相关联。
viewpager不直接处理每一个视图而是将各个视图与一个键联系起来。这个键用来跟踪且唯一代表一个页面,不仅如此,该键还独立于这个页面所在adapter的位置。当pageradapter将要改变的时候他会调用startUpdate
函数,接下来会调用一次或多次的instantiateItem
或者destroyItem
。最后在更新的后期会调用finishUpdate
。当finishUpdate
返回时instantiateItem
返回的对象应该添加到父ViewGroup,destroyItem
返回的对象应该被ViewGroup删除。isViewFromObject(View, Object)
代表了当前的页面是否与给定的键相关联。
自定义Key示例-简单的将位置position最为key
private class MyPagerAdapter extends PagerAdapter {
private List<View> mViewList;
MyPagerAdapter(List<View> viewList) {
mViewList = viewList;
}
@Override
public int getCount() {
Log.i(TAG, NAME + "--getCount");
return mViewList.size();
}
@Override
public int getItemPosition(Object object) {
return super.getItemPosition(object);
}
@Override
public boolean isViewFromObject(View view, Object object) {
Log.i(TAG, NAME + "--isViewFromObject");
return view == mViewList.get((int)Integer.parseInt(object.toString()));
}
@Override
public Object instantiateItem(ViewGroup container, int position) {
View view = mViewList.get(position);
container.addView(view);
Log.i(TAG, NAME + "--instantiateItem++container:" + container.getChildCount() + "++position:" + position);
return position;
}
@Override
public void destroyItem(ViewGroup container, int position, Object object) {
container.removeView(mViewList.get(position));
Log.i(TAG, NAME + "--destroyItem++container:" + container.getChildCount() + "++position:" + position);
}
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 140
public Object instantiateItem (ViewGroup container, int position)
创建指定位置的页面视图。适配器有责任增加即将创建的View视图到给定的container中,确保在finishUpdate(viewGroup)返回时,增加视图的事情已经完成。
该方法的返回值是新增视图页面的Object(Key),这里没必要非要返回视图本身,也可以是这个页面的其它容器,它可以返回和视图相关联的任何值。public void destroyItem (ViewGroup container, int position, Object object)
移除给定位置的view,适配器有责任将该view从container中移除,确保在finishUpdate(viewGroup)返回时,移除视图的事情已经完成。public void startUpdate (ViewGroup container)
在展示的界面中有改变将要发生时调用。public void finishUpdate (ViewGroup container)
展示界面中的改变完成时调用。在这个时间点上,你必须确保所有的页面已被合适的从container中添加或移除。public void notifyDataSetChanged ()
该方法由应用程序在适配器数据改变时主动调用。public void registerDataSetObserver (DataSetObserver observer)
注册一个观察者去接收关联到适配器数据变化的回调。public void unregisterDataSetObserver (DataSetObserver observer)
反注册去接收关联到适配器数据变化的回调的观察者。public void setPrimaryItem (ViewGroup container, int position, Object object)
调用该方法去通知当前适配器的哪一项被考虑为“primary”,它是当前展示给用户的页面。public CharSequence getPageTitle (int position)
该方法由ViewPager在获取描述页面的标题时调用。该方法默认返回null。public float getPageWidth (int position)
该方法返回给定页面的比例宽度,范围(0.f-1.f]。public Parcelable saveState ()
保存与适配器关联的实例状态,当当前UI状态需要重建时恢复。public void restoreState (Parcelable state, ClassLoader loader)
恢复之前由saveState ()
保存的与适配器关联的实例状态。