Android ViewDragHelper完全解析 自定义ViewGroup神器

Android ViewDragHelper完全解析 自定义ViewGroup神器,第1张

概述一、概述在自定义ViewGroup中,很多效果都包含用户手指去拖动其内部的某个View(eg:侧滑菜单等),针对具体的需要去写好onInterceptTouchEvent和onTouchEvent这两个方法是一件很不容易的事,需要自己去处理:多手指的

一、概述

在自定义viewGroup中,很多效果都包含用户手指去拖动其内部的某个VIEw(eg:侧滑菜单等),针对具体的需要去写好onIntercepttouchEvent和ontouchEvent这两个方法是一件很不容易的事,需要自己去处理:多手指的处理、加速度检测等等。
好在官方在v4的支持包中提供了VIEwDragHelper这样一个类来帮助我们方便的编写自定义viewGroup。简单看一下它的注释:

VIEwDragHelper is a utility class for writing custom VIEwGroups. It offers a number
of useful operations and state tracking for allowing a user to drag and reposition
vIEws within their parent VIEwGroup.

本篇博客将重点介绍VIEwDragHelper的使用,并且最终去实现一个类似DrawerLayout的一个自定义的VIEwGroup。(ps:官方的DrawerLayout就是用此类实现)

二、入门小示例

首先我们通过一个简单的例子来看看其快捷的用法,分为以下几个步骤:

创建实例 触摸相关的方法的调用 VIEwDragHelper.Callback实例的编写

(一) 自定义viewGroup

package com.zhy.learn.vIEw;import androID.content.Context;import androID.support.v4.Widget.VIEwDragHelper;import androID.util.AttributeSet;import androID.vIEw.MotionEvent;import androID.vIEw.VIEw;import androID.Widget.linearLayout;/** * Created by zhy on 15/6/3. */public class Vdhlayout extends linearLayout{ private VIEwDragHelper mDragger; public Vdhlayout(Context context,AttributeSet attrs) {  super(context,attrs);  mDragger = VIEwDragHelper.create(this,1.0f,new VIEwDragHelper.Callback()  {   @OverrIDe   public boolean tryCaptureVIEw(VIEw child,int pointerID)   {    return true;   }   @OverrIDe   public int clampVIEwpositionHorizontal(VIEw child,int left,int dx)   {    return left;   }   @OverrIDe   public int clampVIEwpositionVertical(VIEw child,int top,int dy)   {    return top;   }  }); } @OverrIDe public boolean onIntercepttouchEvent(MotionEvent event) {  return mDragger.shouldIntercepttouchEvent(event); } @OverrIDe public boolean ontouchEvent(MotionEvent event) {  mDragger.processtouchEvent(event);  return true; }}

可以看到,上面整个自定义viewGroup的代码非常简洁,遵循上述3个步骤:

1、创建实例

mDragger = VIEwDragHelper.create(this,new VIEwDragHelper.Callback()  {  });

创建实例需要3个参数,第一个就是当前的VIEwGroup,第二个sensitivity,主要用于设置touchSlop:

helper.mtouchSlop = (int) (helper.mtouchSlop * (1 / sensitivity));

可见传入越大,mtouchSlop的值就会越小。第三个参数就是Callback,在用户的触摸过程中会回调相关方法,后面会细说。

2、触摸相关方法

 @OverrIDe public boolean onIntercepttouchEvent(MotionEvent event) {  return mDragger.shouldIntercepttouchEvent(event); } @OverrIDe public boolean ontouchEvent(MotionEvent event) {  mDragger.processtouchEvent(event);  return true; }

onIntercepttouchEvent中通过使用mDragger.shouldIntercepttouchEvent(event)来决定我们是否应该拦截当前的事件。ontouchEvent中通过mDragger.processtouchEvent(event)处理事件。

3、实现VIEwDragHelper.CallCack相关方法

new VIEwDragHelper.Callback()  {   @OverrIDe   public boolean tryCaptureVIEw(VIEw child,int dy)   {    return top;   }  }


VIEwDragHelper中拦截和处理事件时,需要会回调CallBack中的很多方法来决定一些事,比如:哪些子VIEw可以移动、对个移动的VIEw的边界的控制等等。

上面复写的3个方法:

tryCaptureVIEw如何返回ture则表示可以捕获该vIEw,你可以根据传入的第一个vIEw参数决定哪些可以捕获

clampVIEwpositionHorizontal,clampVIEwpositionVertical可以在该方法中对child移动的边界进行控制,left,top 分别为即将移动到的位置,比如横向的情况下,我希望只在VIEwGroup的内部移动,即:最小>=paddingleft,最大<=VIEwGroup.getWIDth()-paddingright-child.getWIDth。就可以按照如下代码编写:

 @OverrIDe   public int clampVIEwpositionHorizontal(VIEw child,int dx)   {    final int leftBound = getpaddingleft();    final int rightBound = getWIDth() - mDragVIEw.getWIDth() - leftBound;    final int newleft = Math.min(Math.max(left,leftBound),rightBound);    return newleft;   }

经过上述3个步骤,我们就完成了一个简单的自定义viewGroup,可以自由的拖动子VIEw。

简单看一下布局文件

(二) 布局文件

<com.zhy.learn.vIEw.Vdhlayout xmlns:androID="@R_419_6822@://schemas.androID.com/apk/res/androID"        xmlns:tools="@R_419_6822@://schemas.androID.com/tools"        androID:layout_wIDth="match_parent"        androID:orIEntation="vertical"        androID:layout_height="match_parent" > <TextVIEw  androID:layout_margin="10dp"  androID:gravity="center"  androID:layout_gravity="center"  androID:background="#44ff0000"  androID:text="I can be dragged !"  androID:layout_wIDth="100dp"  androID:layout_height="100dp"/> <TextVIEw  androID:layout_margin="10dp"  androID:layout_gravity="center"  androID:gravity="center"  androID:background="#44ff0000"  androID:text="I can be dragged !"  androID:layout_wIDth="100dp"  androID:layout_height="100dp"/> <TextVIEw  androID:layout_margin="10dp"  androID:layout_gravity="center"  androID:gravity="center"  androID:background="#44ff0000"  androID:text="I can be dragged !"  androID:layout_wIDth="100dp"  androID:layout_height="100dp"/></com.zhy.learn.vIEw.Vdhlayout>

我们的自定义viewGroup中有三个TextVIEw。

当前效果:

可以看到短短数行代码就可以玩起来了~~~

有了直观的认识以后,我们还需要对VIEwDragHelper.CallBack里面的方法做下深入的理解。首先我们需要考虑的是:我们的VIEwDragHelper不仅仅说只能够去让子VIEw去跟随我们手指移动,我们继续往下学习其他的功能。

三、功能展示

VIEwDragHelper还能做以下的一些 *** 作:

边界检测、加速度检测(eg:DrawerLayout边界触发拉出) 回调Drag Release(eg:DrawerLayout部分,手指抬起,自动展开/收缩) 移动到某个指定的位置(eg:点击button,展开/关闭Drawerlayout)

那么我们接下来对我们最基本的例子进行改造,包含上述的几个 *** 作。

首先看一下我们修改后的效果:

简单的为每个子VIEw添加了不同的 *** 作:

第一个VIEw,就是演示简单的移动
第二个VIEw,演示除了移动后,松手自动返回到原本的位置。(注意你拖动的越快,返回的越快)
第三个VIEw,边界移动时对VIEw进行捕获。

好了,看完效果图,来看下代码的修改:

修改后的代码

package com.zhy.learn.vIEw;import androID.content.Context;import androID.graphics.Point;import androID.support.v4.Widget.VIEwDragHelper;import androID.util.AttributeSet;import androID.vIEw.MotionEvent;import androID.vIEw.VIEw;import androID.Widget.linearLayout;/** * Created by zhy on 15/6/3. */public class Vdhlayout extends linearLayout{ private VIEwDragHelper mDragger; private VIEw mDragVIEw; private VIEw mautoBackVIEw; private VIEw mEdgeTrackerVIEw; private Point mautoBackOriginPos = new Point(); public Vdhlayout(Context context,int pointerID)   {    //mEdgeTrackerVIEw禁止直接移动    return child == mDragVIEw || child == mautoBackVIEw;   }   @OverrIDe   public int clampVIEwpositionHorizontal(VIEw child,int dy)   {    return top;   }   //手指释放的时候回调   @OverrIDe   public voID onVIEwReleased(VIEw releasedChild,float xvel,float yvel)   {    //mautoBackVIEw手指释放时可以自动回去    if (releasedChild == mautoBackVIEw)    {     mDragger.settleCapturedVIEwAt(mautoBackOriginPos.x,mautoBackOriginPos.y);     invalIDate();    }   }   //在边界拖动时回调   @OverrIDe   public voID onEdgeDragStarted(int edgeFlags,int pointerID)   {    mDragger.captureChildVIEw(mEdgeTrackerVIEw,pointerID);   }  });  mDragger.setEdgeTrackingEnabled(VIEwDragHelper.EDGE_left); } @OverrIDe public boolean onIntercepttouchEvent(MotionEvent event) {  return mDragger.shouldIntercepttouchEvent(event); } @OverrIDe public boolean ontouchEvent(MotionEvent event) {  mDragger.processtouchEvent(event);  return true; } @OverrIDe public voID computeScroll() {  if(mDragger.continueSettling(true))  {   invalIDate();  } } @OverrIDe protected voID onLayout(boolean changed,int l,int t,int r,int b) {  super.onLayout(changed,l,t,r,b);  mautoBackOriginPos.x = mautoBackVIEw.getleft();  mautoBackOriginPos.y = mautoBackVIEw.gettop(); } @OverrIDe protected voID onFinishInflate() {  super.onFinishInflate();  mDragVIEw = getChildAt(0);  mautoBackVIEw = getChildAt(1);  mEdgeTrackerVIEw = getChildAt(2); }}

布局文件我们仅仅是换了下文本和背景色就不重复贴了。

第一个VIEw基本没做任何修改。

第二个VIEw,我们在onLayout之后保存了最开启的位置信息,最主要还是重写了Callback中的onVIEwReleased,我们在onVIEwReleased中判断如果是mautoBackVIEw则调用settleCapturedVIEwAt回到初始的位置。大家可以看到紧随其后的代码是invalIDate();因为其内部使用的是mScroller.startScroll,所以别忘了需要invalIDate()以及结合computeScroll方法一起。

第三个VIEw,我们在onEdgeDragStarted回调方法中,主动通过captureChildVIEw对其进行捕获,该方法可以绕过tryCaptureVIEw,所以我们的tryCaptureVIEw虽然并为返回true,但却不影响。注意如果需要使用边界检测需要添加上mDragger.setEdgeTrackingEnabled(VIEwDragHelper.EDGE_left);。

到此,我们已经介绍了Callback中常用的回调方法了,当然还有一些方法没有介绍,接下来我们修改下我们的布局文件,我们把我们的TextVIEw全部加上clickable=true,意思就是子VIEw可以消耗事件。再次运行,你会发现本来可以拖动的VIEw不动了,(如果有拿button测试的兄弟应该已经发现这个问题了,我希望你看到这了,而不是已经提问了,哈~)。

原因是什么呢?主要是因为,如果子VIEw不消耗事件,那么整个手势(DOWN-MOVE*-UP)都是直接进入ontouchEvent,在ontouchEvent的DOWN的时候就确定了captureVIEw。如果消耗事件,那么就会先走onIntercepttouchEvent方法,判断是否可以捕获,而在判断的过程中会去判断另外两个回调的方法:getVIEwHorizontalDragRange和getVIEwVerticalDragRange,只有这两个方法返回大于0的值才能正常的捕获。

所以,如果你用button测试,或者给TextVIEw添加了clickable = true ,都记得重写下面这两个方法:

@OverrIDepublic int getVIEwHorizontalDragRange(VIEw child){  return getMeasureDWIDth()-child.getMeasureDWIDth();}@OverrIDepublic int getVIEwVerticalDragRange(VIEw child){  return getMeasuredHeight()-child.getMeasuredHeight();}

方法的返回值应当是该childVIEw横向或者纵向的移动的范围,当前如果只需要一个方向移动,可以只复写一个。

到此,我们列一下所有的Callback方法,看看还有哪些没用过的:

onVIEwDragStateChanged

当VIEwDragHelper状态发生变化时回调(IDLE,DRAGGING,SETTING[自动滚动时])

onVIEwpositionChanged

当capturevIEw的位置发生改变时回调

onVIEwCaptured

当capturevIEw被捕获时回调

onVIEwReleased 已用

onEdgetouched

当触摸到边界时回调。

onEdgeLock

true的时候会锁住当前的边界,false则unLock。

onEdgeDragStarted 已用

getorderedChildindex

改变同一个坐标(x,y)去寻找captureVIEw位置的方法。(具体在:findtopChildUnder方法中)

getVIEwHorizontalDragRange 已用

getVIEwVerticalDragRange 已用

tryCaptureVIEw 已用

clampVIEwpositionHorizontal 已用

clampVIEwpositionVertical 已用

ok,至此所有的回调方法都有了一定的认识。

总结下,方法的大致的回调顺序:

shouldIntercepttouchEvent:DOWN:  getorderedChildindex(findtopChildUnder)  ->onEdgetouchedMOVE:  getorderedChildindex(findtopChildUnder)  ->getVIEwHorizontalDragRange &    getVIEwVerticalDragRange(checktouchSlop)(MOVE中可能不止一次)  ->clampVIEwpositionHorizontal&   clampVIEwpositionVertical  ->onEdgeDragStarted  ->tryCaptureVIEw  ->onVIEwCaptured  ->onVIEwDragStateChangedprocesstouchEvent:DOWN:  getorderedChildindex(findtopChildUnder)  ->tryCaptureVIEw  ->onVIEwCaptured  ->onVIEwDragStateChanged  ->onEdgetouchedMOVE:  ->STATE==DRAGGING:dragTo  ->STATE!=DRAGGING:    onEdgeDragStarted    ->getorderedChildindex(findtopChildUnder)    ->getVIEwHorizontalDragRange&     getVIEwVerticalDragRange(checktouchSlop)    ->tryCaptureVIEw    ->onVIEwCaptured    ->onVIEwDragStateChanged

ok,上述是正常情况下大致的流程,当然整个过程可能会存在很多判断不成立的情况。

从上面也可以解释,我们在之前TextVIEw(clickable=false)的情况下,没有编写getVIEwHorizontalDragRange方法时,是可以移动的。因为直接进入processtouchEvent的DOWN,然后就onVIEwCaptured、onVIEwDragStateChanged(进入DRAGGING状态),接下来MOVE就直接dragTo了。

而当子VIEw消耗事件的时候,就需要走shouldIntercepttouchEvent,MOVE的时候经过一系列的判断(getVIEwHorizontalDragRange,clampVIEwpositionVertical等),才能够去tryCaptureVIEw。

ok,到此VIEwDragHelper的入门用法我们就介绍结束了,下一篇,我们将使用VIEwDragHelper去自己实现一个DrawerLayout。
有兴趣的也可以根据本文,以及DrawerLayout的源码去实现了~

参考链接

http://flavienlaurent.com/blog/2013/08/28/each-navigation-drawer-hides-a-viewdraghelper/
http://blog.denevell.org/android-viewdraghelper-example-tutorial.html

~~have a nice day ~~

源码点击下载

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持编程小技巧。

总结

以上是内存溢出为你收集整理的Android ViewDragHelper完全解析 自定义ViewGroup神器全部内容,希望文章能够帮你解决Android ViewDragHelper完全解析 自定义ViewGroup神器所遇到的程序开发问题。

如果觉得内存溢出网站内容还不错,欢迎将内存溢出网站推荐给程序员好友。

欢迎分享,转载请注明来源:内存溢出

原文地址: http://outofmemory.cn/web/1146573.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2022-05-31
下一篇 2022-05-31

发表评论

登录后才能评论

评论列表(0条)

保存