【PullToRefresh 系列基本用法】 Android装上拉下拉刷新控制具体的解释


转载请注明:http://blog.csdn.net/duguang77/article/details/40921601

作者信息:

Chris Banes大神详情https://github.com/chrisbanes

PullToRefresh控件下载地址:https://github.com/chrisbanes/Android-PullToRefresh

百度网盘下载地址:http://pan.baidu.com/s/1o6umifw



(一)导入方法:

1.下载后将extras。library,sample导入到Eclipse中



2.导入后时可能会报错,请更改依赖包位置



(二)用法:

我们一般用的比較多的就是单纯的ListView,
当然其它的情况比方GridView,WebView等等。作者也有直接写好的控件。大家直接用就好



以下我们看下使用的基本方法

1.XML布局文件的代码

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.example.testpulltoreresh.MainActivity" >

    <com.handmark.pulltorefresh.library.PullToRefreshListView
        android:id="@+id/pl_refresh"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</RelativeLayout>


2.设置PullToRefresh的监听事件

mPullList.setOnRefreshListener(new OnRefreshListener2() {

			@Override
			public void onPullDownToRefresh(PullToRefreshBase refreshView) {
				// 下拉刷新触发的事件
				//获取格式化的时间
				String label = DateUtils.formatDateTime(getApplicationContext(), System.currentTimeMillis(),
						DateUtils.FORMAT_SHOW_TIME | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_ABBREV_ALL);

				//	更新LastUpdatedLabel
				refreshView.getLoadingLayoutProxy().setLastUpdatedLabel(label);
				
				///开启线程模拟调接口填充数据
				new GetDataTask().execute();
			}

			@Override
			public void onPullUpToRefresh(PullToRefreshBase refreshView) {
				// 上提载入触发的事件
				///开启线程模拟调接口填充数据
				new GetDataTask().execute();
			}
		});

3.设置下拉。上提功能是否可用

// 设置PullToRefreshListView的模式
		//Mode.DISABLED 禁用全部ListView动作和刷新处理
		//Mode.MANUAL_REFRESH_ONLY 被废弃的动作。禁用下拉动作处理,可是同意通过手动设置刷新状态
		//Mode.PULL_DOWN_TO_REFRESH 被废弃的动作。仅仅有下拉动作
		//Mode.PULL_UP_TO_REFRESH  被废弃的动作。仅仅有上提动作
		
		//Mode.PULL_FROM_END 仅仅有上拉动作
		//Mode.PULL_FROM_START 仅仅同意用户将从一開始就可刷新视图刷新。一開始是顶部或离开时,依据滚动方向。仅仅有下拉动作
		//Mode.BOTH 下拉上提全部动作
		mPullList.setMode(Mode.BOTH);

或者是通过XML文件直接设置MODE属性
ptr:ptrMode="both"


只是要注意要增加命名空间
xmlns:ptr="http://schemas.android.com/apk/res-auto"

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.example.testpulltoreresh.MainActivity" >

    <com.handmark.pulltorefresh.library.PullToRefreshListView
        xmlns:ptr="http://schemas.android.com/apk/res-auto"
        android:id="@+id/pl_refresh"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:cacheColorHint="#00000000"
        android:divider="#19000000"
        android:dividerHeight="0.5dp"
        android:fadingEdge="none"
        android:fastScrollEnabled="false"
        android:footerDividersEnabled="false"
        android:headerDividersEnabled="false"
        android:smoothScrollbar="true"
        ptr:ptrMode="both"/>

</RelativeLayout>


4.设置下拉,上提载入的提示

		// 设置PullRefreshListView上提载入时的载入提示
		mPullList.setMode(Mode.BOTH);
		mPullList.getLoadingLayoutProxy(false, true).setPullLabel("上拉载入...");
		mPullList.getLoadingLayoutProxy(false, true).setRefreshingLabel("正在载入...");
		mPullList.getLoadingLayoutProxy(false, true).setReleaseLabel("松开载入很多其它...");

		// 设置PullRefreshListView下拉载入时的载入提示
		mPullList.getLoadingLayoutProxy(true, false).setPullLabel("下拉刷新...");
		mPullList.getLoadingLayoutProxy(true, false).setRefreshingLabel("正在载入...");
		mPullList.getLoadingLayoutProxy(true, false).setReleaseLabel("松开载入很多其它...");


5.设置下拉。上提刷新的载入动画

ptr:ptrAnimationStyle="flip" 翻转动画
<pre name="code" class="java">ptr:ptrAnimationStyle="rotate"<span style="white-space:pre">	</span>旋转动画


    <com.handmark.pulltorefresh.library.PullToRefreshListView
        xmlns:ptr="http://schemas.android.com/apk/res-auto"
       .......................
        ptr:ptrAnimationStyle="flip"/>

旋转动画:



翻转动画



6.更改下拉时的icon

    <com.handmark.pulltorefresh.library.PullToRefreshListView
        xmlns:ptr="http://schemas.android.com/apk/res-auto"
        ........
        ptr:ptrDrawable="@drawable/ic_rockets" />







7.其它的一些经常使用属性

//设置整个mPullRefreshListView的背景色
		ptrRefreshableViewBackground 
		
		//设置下拉Header或者上拉Footer的背景色
		ptrHeaderBackground 
		
		//用于设置Header与Footer中文本的颜色
		ptrHeaderTextColor 
		
		//用于设置Header与Footer中上次刷新时间的颜色
		ptrHeaderSubTextColor 
		
		//假设为true会在mPullRefreshListView中出现icon,右上角和右下角,挺有意思的。
		ptrShowIndicator
		
		//以下两个分别设置拉Header或者上拉Footer中字体的类型颜色等等。
		ptrHeaderTextAppearance,ptrSubHeaderTextAppearance
		
		//当动画设置为rotate时,下拉是是否旋转。

ptrRotateDrawableWhilePulling //刷新的时候,是否同意ListView或GridView滚动。认为为true比較好。 ptrScrollingWhileRefreshingEnabled //决定了Header,Footer以何种方式增加mPullRefreshListView,true为headView方式增加。就是滚动时刷新头部会一起滚动。 ptrListViewExtrasEnabled //最后2个事实上对于用户体验还是挺重要的。假设设置的时候考虑下。其它的属性自己选择就好。 //注:上述属性非常多都能够代码控制。假设有须要能够直接mPullRefreshListView.set属性名 查看 //以上为PullToRefresh全部支持的属性~~






我的Demoproject全部代码

public class MainActivity extends Activity {

	private PullToRefreshListView mPullList;
	private LinkedList<String> mListItems;
	private ArrayAdapter<String> mAdapter;
	
	private String[] mStrings = { "我非常善良", "我非常温和", "我是淘女郎", 
			"我是阿里郎", "我是大灰狼","我是羊羊羊" };

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		initView();
		setEventListener();
		initData();
	}

	/**
	 * 初始化控件
	 */
	private void initView() {
		mPullList = (PullToRefreshListView) findViewById(R.id.pl_refresh);

	}

	/**
	 * 设置监听
	 */
	private void setEventListener() {
		mPullList.setOnRefreshListener(new OnRefreshListener2() {

			@Override
			public void onPullDownToRefresh(PullToRefreshBase refreshView) {
				// 下拉刷新触发的事件
				//获取格式化的时间
				String label = DateUtils.formatDateTime(getApplicationContext(), System.currentTimeMillis(),
						DateUtils.FORMAT_SHOW_TIME | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_ABBREV_ALL);

				//	更新LastUpdatedLabel
				refreshView.getLoadingLayoutProxy().setLastUpdatedLabel(label);
				
				///开启线程模拟调接口填充数据
				new GetDataTask().execute();
			}

			@Override
			public void onPullUpToRefresh(PullToRefreshBase refreshView) {
				// 上提载入触发的事件
				///开启线程模拟调接口填充数据
				new GetDataTask().execute();
			}
		});

	}

	/**
	 * 初始化数据
	 */
	private void initData() {
		// 设置PullToRefreshListView的模式
		mPullList.setMode(Mode.BOTH);

		// 设置PullRefreshListView上提载入时的载入提示
		mPullList.setMode(Mode.BOTH);
		mPullList.getLoadingLayoutProxy(false, true).setPullLabel("上拉载入...");
		mPullList.getLoadingLayoutProxy(false, true).setRefreshingLabel("正在载入...");
		mPullList.getLoadingLayoutProxy(false, true).setReleaseLabel("松开载入很多其它...");

		// 设置PullRefreshListView下拉载入时的载入提示
		mPullList.getLoadingLayoutProxy(true, false).setPullLabel("下拉刷新...");
		mPullList.getLoadingLayoutProxy(true, false).setRefreshingLabel("正在载入...");
		mPullList.getLoadingLayoutProxy(true, false).setReleaseLabel("松开载入很多其它...");
		
		mListItems = new LinkedList<String>();
		mListItems.addAll(Arrays.asList(mStrings));

		mAdapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, mListItems);
		mPullList.setAdapter(mAdapter);

	}
	
	private class GetDataTask extends AsyncTask<Void, Void, String[]> {

		@Override
		protected String[] doInBackground(Void... params) {
			try {
				Thread.sleep(2000);
			} catch (InterruptedException e) {
			}
			return null;
		}

		@Override
		protected void onPostExecute(String[] result) {
			if(mPullList.isHeaderShown()){
				mListItems.addFirst("我是新纳入的妾——下拉刷新");
			}else if(mPullList.isFooterShown()){
				mListItems.addLast("我是让你重回怀抱的妾——上提载入");
			}
		
			mAdapter.notifyDataSetChanged();

			// 调用刷新完毕
			mPullList.onRefreshComplete();

			super.onPostExecute(result);
		}
	}
	
	

}





原文地址:https://www.cnblogs.com/blfshiye/p/4588326.html