PullToRefreshListView 应用讲解

转载于http://blog.csdn.net/mmjiajia132/article/details/40397813

PullToRefreshListView 用法和ListView 没有什么区别  listview能用的属性 pulltorefresh也能用

我一直认为动手是最好的学习方法...

一:首先看布局文件

 

  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     android:layout_width="match_parent"  
  4.     android:layout_height="match_parent"  
  5.     android:orientation="vertical" >  
  6.       
  7.     <!--     ptr:ptrAnimationStyle="flip"  flip:翻转  rotate:旋转-->  
  8.     <!--     ptr:ptrShowIndicator="true"  右上角 右下角出现箭头-->  
  9.     <com.handmark.pulltorefresh.library.PullToRefreshListView  
  10.         xmlns:ptr="http://schemas.android.com/apk/res-auto"  
  11.         android:id="@+id/pullToRefresh"  
  12.         android:layout_width="match_parent"  
  13.         android:layout_height="wrap_content"  
  14.         ptr:ptrDrawable="@drawable/default_ptr_flip"   
  15.         ptr:ptrAnimationStyle="flip"  
  16.         ptr:ptrHeaderBackground="#383838"  
  17.         ptr:ptrHeaderTextColor="#FFFFFF"  
  18.         />  
  19.   
  20. </LinearLayout>  


ptr是pullToRefresh的配置属性 使用是需要添加 xmlns:ptr="http://schemas.android.com/apk/res-auto"

 

ptr:ptrDrawable=“” 上拉下拉图标
ptr:ptrAnimationStyle=""  图标动画  取值: flip:翻转 rotate旋转
ptr:ptrHeaderBackground=""  上拉下拉时 头部的背景色
ptr:ptrHeaderTextColor=""     上拉下拉时 文字颜色

还有一些常用属性

ptrRefreshableViewBackground 设置整个mPullRefreshListView的背景色

 

ptrScrollingWhileRefreshingEnabled刷新的时候,是否允许ListView或GridView滚动。觉得为true比较好。

ptrListViewExtrasEnabled 决定了Header,Footer以何种方式加入mPullRefreshListView,true为headView方式加入,就是滚动时刷新头部会一起滚动。

注:上述属性都可以代码添加,请用pullToRefresh.set查看

二:MainActivity代码

 

  1. public class MainActivity extends ActionBarActivity {  
  2.       
  3.     private PullToRefreshListView pullToRefresh;  
  4.     private List<PullBean> data = new ArrayList<PullBean>();  
  5.     MyAdapter adapter;  
  6.     @Override  
  7.     protected void onCreate(Bundle savedInstanceState) {  
  8.         super.onCreate(savedInstanceState);  
  9.         setContentView(R.layout.main);  
  10.         pullToRefresh = (PullToRefreshListView) findViewById(R.id.pullToRefresh);  
  11.         data = getData();  
  12.         adapter = new MyAdapter(this);  
  13.         pullToRefresh.setAdapter(adapter);  
  14.         /* 
  15.          * Mode.BOTH:同时支持上拉下拉 
  16.          * Mode.PULL_FROM_START:只支持下拉Pulling Down 
  17.          * Mode.PULL_FROM_END:只支持上拉Pulling Up 
  18.          */  
  19.         /* 
  20.          * 如果Mode设置成Mode.BOTH,需要设置刷新Listener为OnRefreshListener2,并实现onPullDownToRefresh()、onPullUpToRefresh()两个方法。  
  21.          * 如果Mode设置成Mode.PULL_FROM_START或Mode.PULL_FROM_END,需要设置刷新Listener为OnRefreshListener,同时实现onRefresh()方法。 
  22.          * 当然也可以设置为OnRefreshListener2,但是Mode.PULL_FROM_START的时候只调用onPullDownToRefresh()方法, 
  23.          * Mode.PULL_FROM的时候只调用onPullUpToRefresh()方法.  
  24.          */  
  25.         pullToRefresh.setMode(Mode.BOTH);  
  26.         init();  
  27.           
  28.         /* 
  29.          * setOnRefreshListener(OnRefreshListener listener):设置刷新监听器; 
  30.          * setOnLastItemVisibleListener(OnLastItemVisibleListener listener):设置是否到底部监听器; 
  31.          * setOnPullEventListener(OnPullEventListener listener);设置事件监听器; 
  32.          * onRefreshComplete():设置刷新完成 
  33.          */  
  34.         /* 
  35.          * pulltorefresh.setOnScrollListener() 
  36.          */  
  37.         // SCROLL_STATE_TOUCH_SCROLL(1) 正在滚动      
  38.         // SCROLL_STATE_FLING(2) 手指做了抛的动作(手指离开屏幕前,用力滑了一下)      
  39.         // SCROLL_STATE_IDLE(0) 停止滚动         
  40.         /* 
  41.          * setOnLastItemVisibleListener 
  42.          * 当用户拉到底时调用   
  43.          */  
  44.         /* 
  45.          * setOnTouchListener是监控从点下鼠标 (可能拖动鼠标)到放开鼠标(鼠标可以换成手指)的整个过程 ,他的回调函数是onTouchEvent(MotionEvent event), 
  46.          * 然后通过判断event.getAction()是MotionEvent.ACTION_UP还是ACTION_DOWN还是ACTION_MOVE分别作不同行为。 
  47.          * setOnClickListener的监控时间只监控到手指ACTION_DOWN时发生的行为 
  48.          */  
  49.         pullToRefresh.setOnRefreshListener(new OnRefreshListener2<ListView>(){  
  50.             @Override  
  51.             public void onPullDownToRefresh(  
  52.                     PullToRefreshBase<ListView> refreshView) {  
  53.                 // TODO Auto-generated method stub  
  54.                  PullBean bean = new PullBean();  
  55.                  bean.setTitle("下拉刷新");  
  56.                  bean.setContent("我的神");  
  57.                  adapter.addFirst(bean);  
  58.                  new FinishRefresh().execute();  
  59.                  adapter.notifyDataSetChanged();  
  60.             }  
  61.               
  62.             @Override  
  63.             public void onPullUpToRefresh(  
  64.                     PullToRefreshBase<ListView> refreshView) {  
  65.                 // TODO Auto-generated method stub  
  66.                 PullBean bean = new PullBean();  
  67.                 bean.setTitle("上拉刷新");  
  68.                 bean.setContent("我的神");  
  69.                 adapter.addLast(bean);  
  70.                 new FinishRefresh().execute();  
  71.                 adapter.notifyDataSetChanged();  
  72.             }  
  73.         });  
  74.           
  75.       
  76. //      pullToRefresh.setOnRefreshListener(new OnRefreshListener<ListView>() {  
  77. //  
  78. //          @Override  
  79. //          public void onRefresh(PullToRefreshBase<ListView> refreshView) {  
  80. //              // TODO Auto-generated method stub  
  81. //              String label = DateUtils.formatDateTime(getApplicationContext(), System.currentTimeMillis(),    
  82. //                        DateUtils.FORMAT_SHOW_TIME | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_ABBREV_ALL);    
  83. //    
  84. //                // Update the LastUpdatedLabel    
  85. //                refreshView.getLoadingLayoutProxy().setLastUpdatedLabel(label);  
  86. //                PullBean bean = new PullBean();  
  87. //                bean.setTitle("我的神");  
  88. //                bean.setContent("我的神");  
  89. //                adapter.addFirst(bean);  
  90. //                new FinishRefresh().execute();  
  91. //          }  
  92. //            
  93. //      });  
  94.     }  
  95.       
  96.     private void init()    
  97.     {    
  98.         ILoadingLayout startLabels = pullToRefresh    
  99.                 .getLoadingLayoutProxy(true, false);    
  100.         startLabels.setPullLabel("下拉刷新...");// 刚下拉时,显示的提示    
  101.         startLabels.setRefreshingLabel("正在载入...");// 刷新时    
  102.         startLabels.setReleaseLabel("放开刷新...");// 下来达到一定距离时,显示的提示    
  103.     
  104.         ILoadingLayout endLabels = pullToRefresh.getLoadingLayoutProxy(    
  105.                 false, true);    
  106.         endLabels.setPullLabel("上拉刷新...");// 刚下拉时,显示的提示    
  107.         endLabels.setRefreshingLabel("正在载入...");// 刷新时    
  108.         endLabels.setReleaseLabel("放开刷新...");// 下来达到一定距离时,显示的提示    
  109.           
  110. //      // 设置下拉刷新文本  
  111. //      pullToRefresh.getLoadingLayoutProxy(false, true)  
  112. //              .setPullLabel("上拉刷新...");  
  113. //      pullToRefresh.getLoadingLayoutProxy(false, true).setReleaseLabel(  
  114. //              "放开刷新...");  
  115. //      pullToRefresh.getLoadingLayoutProxy(false, true).setRefreshingLabel(  
  116. //              "正在加载...");  
  117. //      // 设置上拉刷新文本  
  118. //      pullToRefresh.getLoadingLayoutProxy(true, false)  
  119. //              .setPullLabel("下拉刷新...");  
  120. //      pullToRefresh.getLoadingLayoutProxy(true, false).setReleaseLabel(  
  121. //              "放开刷新...");  
  122. //      pullToRefresh.getLoadingLayoutProxy(true, false).setRefreshingLabel(  
  123. //              "正在加载...");  
  124.     }    
  125.       
  126.     private List<PullBean> getData(){  
  127.         List<PullBean> list = new ArrayList<PullBean>();  
  128.         for(int i = 0;i < 10;i ++){  
  129.             PullBean bean = new PullBean();  
  130.             bean.setTitle("item " + i + " 搜索业务增速下滑 Google廉颇老矣?");  
  131.             bean.setContent("Google于10月17日发布了2014年第三季度财报");  
  132.             list.add(bean);  
  133.         }  
  134.           
  135.         return list;  
  136.     }  
  137.       
  138.     private class FinishRefresh extends AsyncTask<Void, Void, Void>{    
  139.         @Override    
  140.         protected Void doInBackground(Void... params) {    
  141.              try {    
  142.                  Thread.sleep(1000);    
  143.              } catch (InterruptedException e) {    
  144.              }    
  145.             return null;    
  146.         }    
  147.      
  148.         @Override    
  149.         protected void onPostExecute(Void result){    
  150. //          adapter.notifyDataSetChanged();  
  151.             pullToRefresh.onRefreshComplete();    
  152.         }    
  153.     }    
  154.       
  155.     private class MyAdapter extends BaseAdapter{  
  156.         private LayoutInflater mInflater;  
  157.           
  158.         public MyAdapter(Context context) {  
  159.             // TODO Auto-generated constructor stub  
  160.             mInflater = LayoutInflater.from(context);  
  161.         }  
  162.           
  163.         public void addFirst(PullBean bean){  
  164.             data.add(0, bean);  
  165.         }  
  166.           
  167.         public void addLast(PullBean bean){  
  168.             data.add(bean);  
  169.         }  
  170.           
  171.         @Override  
  172.         public int getCount() {  
  173.             // TODO Auto-generated method stub  
  174.             return data.size();  
  175.         }  
  176.           
  177.         @Override  
  178.         public Object getItem(int position) {  
  179.             // TODO Auto-generated method stub  
  180.             return data.get(position);  
  181.         }  
  182.           
  183.         @Override  
  184.         public long getItemId(int position) {  
  185.             // TODO Auto-generated method stub  
  186.             return 0;  
  187.         }  
  188.           
  189.         @Override  
  190.         public View getView(int position, View convertView, ViewGroup parent) {  
  191.             // TODO Auto-generated method stub  
  192.             ViewHolder viewHolder = null;  
  193.             if(convertView == null){  
  194.                 viewHolder = new ViewHolder();  
  195.                 convertView = mInflater.inflate(R.layout.item, null);  
  196.                 viewHolder.title = (TextView) convertView.findViewById(R.id.title);  
  197.                 viewHolder.content = (TextView) convertView.findViewById(R.id.content);  
  198.                   
  199.                 convertView.setTag(viewHolder);  
  200.             }else{  
  201.                 viewHolder = (ViewHolder) convertView.getTag();  
  202.             }  
  203.               
  204.             viewHolder.title.setText(data.get(position).getTitle());  
  205.             viewHolder.content.setText(data.get(position).getContent());  
  206.               
  207.             return convertView;  
  208.         }  
  209.           
  210.         class ViewHolder{  
  211.             TextView title;  
  212.             TextView content;  
  213.         }  
  214.     }  
  215.   
  216.       
  217.   
  218. }  


pullToRefresh适配器Adapter和listview也是继承于BaseAdapter 看一下item的布局

 

item.xml

 

  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     android:layout_width="match_parent"  
  4.     android:layout_height="match_parent"  
  5.     android:padding="5dp"  
  6.     android:orientation="vertical" >  
  7.       
  8.     <TextView  
  9.         android:id="@+id/title"  
  10.         android:layout_width="wrap_content"  
  11.         android:layout_height="wrap_content"  
  12.         android:textSize="18sp"  
  13.         android:textColor="#BA55D3"  
  14.         android:text="我的神"/>  
  15.       
  16.     <TextView   
  17.         android:id="@+id/content"  
  18.         android:layout_width="wrap_content"  
  19.         android:layout_height="wrap_content"  
  20.         android:textSize="14.0sp"  
  21.         android:layout_marginTop="5dp"  
  22.         android:textColor="#7CFC00"  
  23.         android:text="我的神"/>  
  24. </LinearLayout>  


pullToRefresh 通过setMode来设置是否可以上拉下拉

 

Mode.BOTH:同时支持上拉下拉

Mode.PULL_FROM_START:只支持下拉Pulling Down

Mode.PULL_FROM_END:只支持上拉Pulling Up

也可以用 ptr:ptrMode="both"

可选值为:disabled(禁用下拉刷新),pullFromStart(仅支持下拉刷新),pullFromEnd(仅支持上拉刷新),both(二者都支持),manualOnly(只允许手动触发)

如果Mode设置成Mode.BOTH,需要设置刷新Listener为OnRefreshListener2,并实现onPullDownToRefresh()、onPullUpToRefresh()两个方法。 

如果Mode设置成Mode.PULL_FROM_START或Mode.PULL_FROM_END,需要设置刷新Listener为OnRefreshListener,同时实现onRefresh()方法。

当然也可以设置为OnRefreshListener2,但是Mode.PULL_FROM_START的时候只调用onPullDownToRefresh()方法,Mode.PULL_FROM的时候只调用onPullUpToRefresh()方法.

如果想上拉、下拉刷新的时候 做一样的操作,那就用OnRefreshListener,上拉下拉的时候都调用

如果想上拉、下拉做不一样的的操作,那就在setOnRefreshListener时 用new OnRefreshListener2<ListView>

当然如果想自己设置上拉下拉中的文字 可以这样

 

  1. ILoadingLayout startLabels = pullToRefresh    
  2.          .getLoadingLayoutProxy(true, false);    
  3.  startLabels.setPullLabel("下拉刷新...");// 刚下拉时,显示的提示    
  4.  startLabels.setRefreshingLabel("正在载入...");// 刷新时    
  5.  startLabels.setReleaseLabel("放开刷新...");// 下来达到一定距离时,显示的提示    
  6.   
  7.  ILoadingLayout endLabels = pullToRefresh.getLoadingLayoutProxy(    
  8.          false, true);    
  9.  endLabels.setPullLabel("上拉刷新...");// 刚下拉时,显示的提示    
  10.  endLabels.setRefreshingLabel("正在载入...");// 刷新时    
  11.  endLabels.setReleaseLabel("放开刷新...");// 下来达到一定距离时,显示的提示    

 

当然也可以这样

 

  1.              pullToRefresh.getLoadingLayoutProxy(false, true)  
  2.         .setPullLabel("上拉刷新...");  
  3. pullToRefresh.getLoadingLayoutProxy(false, true).setReleaseLabel(  
  4.         "放开刷新...");  
  5. pullToRefresh.getLoadingLayoutProxy(false, true).setRefreshingLabel(  
  6.         "正在加载...");  
  7. // 设置上拉刷新文本  
  8. pullToRefresh.getLoadingLayoutProxy(true, false)  
  9.         .setPullLabel("下拉刷新...");  
  10. pullToRefresh.getLoadingLayoutProxy(true, false).setReleaseLabel(  
  11.         "放开刷新...");  
  12. pullToRefresh.getLoadingLayoutProxy(true, false).setRefreshingLabel(  
  13.         "正在加载...");  

 

 

显然在实际操作的时候也会用到其他监听

 setOnScrollListener()

 SCROLL_STATE_TOUCH_SCROLL 正在滚动    
 SCROLL_STATE_FLING 手指做了抛的动作(手指离开屏幕前,用力滑了一下)    
 SCROLL_STATE_IDLE 停止滚动     

setOnLastItemVisibleListener

当用户拉到底时调用  

setOnItemClickListener()

为pullToRefresh中每一个item设置事件

代码下载:点击下载代码

下拉上拉 图标和文字 位置改动是在PullToRefresh源代码中改的即:PullToRefreshListView.handleStyledAttributes 中lp的Gravity改为CENTER_VERTICAL

如果想要改动图标和文字的距离和布局 在这library项目下这两个文件改

pull_to_refresh_header_horizontal.xml

pull_to_refresh_header_vertical.xml

参考博客:

http://blog.csdn.net/lmj623565791/article/details/38238749

http://blog.csdn.net/harvic880925/article/details/17680305

谢谢原作者

持续更新ing MMjiajia132

posted @ 2014-11-14 15:44  -j神-----  阅读(76073)  评论(4编辑  收藏  举报