Cocos2d-x【深入浅出】 ScrollView的delegate实现过程

有小伙伴和我私聊时说在看过我写的那篇 delegate相关的博文后,回过头再看看ScrollView委托的实现过程还是有点吃力。我赶紧搜出之前那篇博文看了看…不禁感慨:

尼玛,这写的都是些啥?!怎么我自己都看晕了?

做人要厚道!写博要实在!为了弥补之前的不足,下面我就以一个新手的角度(其实自己就是新手)来研究下ScrollView的委托实现流程到底是怎样的。

1、首先进入ScrollView.h文件中,在声明ScrollView这个类之前先声明一个委托类,之所以称之为委托,因为它的命名中包含 delegate 这个词。如下:

class ScrollView; //前向声明scrollView  
  
class ScrollViewDelegate  
{  
public:  
    virtual ~ScrollViewDelegate() {}  
  
    virtual void scrollViewDidScroll(ScrollView* view) = 0;  
    virtual void scrollViewDidZoom(ScrollView* view) = 0;  
};  
```

可以看到在这个委托类的声明里有两个函数,一个是scrollViewDidScroll(),这是当scrollView在被拖动时会响应该函数;另一个是scrollViewDidZoom,我想应该是当scrollView在进行缩放时会响应该函数。


2、接下来就是声明ScrollView这个类了。一开始我本能认为既然ScrollView要与ScrollViewDelegate这个类关联起来,那么它就应该继承ScrollViewDelegate吧?可实际上并没有,ScrollView只是单纯的继承一个Layer罢了,如下:
class ScrollView : public Layer{};  
```

问题来了,
ScrollView既然与ScrollViewDelegate没有“父子”关系,那么它是如何调用ScrollViewDelegate中的那些函数的呢?我继续看下ScrollView的类声明。
发现有这么两个函数:
ScrollViewDelegate* getDelegate() { return _delegate; }  
void setDelegate(ScrollViewDelegate* pDelegate) { _delegate = pDelegate; }  
ScrollViewDelegate* _delegate;  
```

这里比较容易理解,先声明一个ScrollViewDelegate* 类型的成员变量,然后通过setDelegate() 与 getDelegate()分别设置与获取_delegate相应的对象。

看到这里好像还不是很理解_delegate到底该怎么用,那起码有一些眉目了,毕竟ScrollViewDelegate已经浮出水面,不是那么神秘。继续往下看。


3、在ScrollView.cpp文件中,我开始找下_delegate这个成员变量都在哪里使用过。很快我在setContentOffset()这个函数中找到它的身影。
void ScrollView::setContentOffset(Point offset, bool animated/* = false*/)  
{  
    if (animated)  
    { //animate scrolling  
        this->setContentOffsetInDuration(offset, BOUNCE_DURATION);  
    }   
    else  
    {   
    ...     ...  
        if (_delegate != NULL)  
        {  
            _delegate->scrollViewDidScroll(this);   //就是这里。  
        }  
    }  
}  
```

setContentOffset()这个函数大家应该都很熟悉了,就是通过它来设置scrollView的偏移的。我们从上面的代码可以看到每当我们调用到setContentOffset()时,只要_delegate这个变量不为空,那么都会调用下面这行代码:
_delegate->scrollViewDidScroll(this);  
```

没错,ScrollView就是在这里调用到ScrollViewDelegate委托类中声明的函数scrollViewDidScroll,它的参数 this 也就是ScrollView这个类所指向的对象啦,我在这里就不多做解释啦。

知道了上面这些,接下来就好办了,我们只要知道在ScrollView中哪里有调用到setContentOffset() 这个函数就可以了。

4、我往下搜索 setContentOffset 这个关键词,发现有在好几个地方调用到,其中最关键的还是在onTouchMoved()这个触摸回调函数中使用到。
onTouchMoved我也不用再多说了,每当我们触摸屏幕拖动时都会响应该函数,下面看下它的缩减版代码:
void ScrollView::onTouchMoved(Touch* touch, Event* event)  
{  
    if (!this->isVisible())  
    {  
        return;  
    }  
  
    if (std::find(_touches.begin(), _touches.end(), touch) != _touches.end())  
    {  
        if (_touches.size() == 1 && _dragging)  
        { // scrolling  
            ...  
              
            if (frame.containsPoint(this->convertToWorldSpace(newPoint)))  
            {  
                ...  
                this->setContentOffset(Point(newX, newY));//在这里调用到  
            }  
        }  
        else if (_touches.size() == 2 && !_dragging)  
        {  
            const float len = _container->convertTouchToNodeSpace(_touches).getDistance(  
                                            _container->convertTouchToNodeSpace(_touches));  
            this->setZoomScale(this->getZoomScale()*len/_touchLength);//这里是调用与缩放相关的函数  
        }  
    }  
}  
```

5、好了,说到这里一切都已经开始变得清晰了!现在我先整理下发型,然后简短的做个总结。
1) 首先在scrollView拖动过程中都会调用onTouchMoved()函数,然后再该函数中调用到到setContainOffset()这个函数,这个函数就是用来设置它的偏移位置的;
2) 在setContainOffset() 会调用到_delegate中的 scrollViewDidScroll()函数。
3) 为什么_delegate能有这么大的权力调用ScrollViewDelegate中的函数呢?原因就在于它是ScrollViewDelegate声明的,说直接点它就是ScrollViewDelegate的私生子!!!

6、下面我举个例子吧。
我先声明一个叫CoolStar的类,
class CoolStar : public Layer,public ScrollViewDelegate  
{  
public:  
    ...  
    bool init();  
    CREATE_FUNC(CoolStar);  
    ...   
    //scroll 委托  
    void scrollViewDidScroll(MyScrollView* view);  
    void scrollViewDidZoom(MyScrollView* view);  
}  
CoolStar为什么要继承ScrollViewDelegate呢?别急,往下看init()函数的定义。  
bool CoolStar::init()  
{  
    auto scroll_layer = Layer::create();  
    ...  
      
    auto m_scroll = ScrollView::create(Size(...),scroll_layer);  
    m_scroll->setDelegate(this);//看这里!!!  
  
    return true;  
}  
```

上面我创建了一个scrollView,然后设置scrollView的委托指向当前类的对象,也就是this(看注释的地方)
而我们知道setDelegate()这个函数是有参数的,它的参数是一个指向ScrollViewDelegate委托类的指针, 如下:
void setDelegate(ScrollViewDelegate* pDelegate);
```
  
这就要求我们创建ScrollView的这个类必须是继承与ScrollViewDelegate,否则你就无法如此洒脱的执行下面这步了:
m_scroll->setDelegate(this);  
```

恩,现在应该知道为什么CoolStar这个类为什么要继承与ScrollViewDelegate委托类了吧。
接下来定义两个scrollView的委托函数:
void CoolStar::scrollViewDidScroll(ScrollView* view)  
{  
    CCLOG("star is so cool");  
}  
void CoolStar::scrollViewDidZoom(ScrollView* view)  
{  
}  
```

运行程序,发现每次拖动scrollView时控制台都会输出 "star is so cool"这串字符串。

不错,Cocos2d-x涉及了很多设计模式,这个就是典型的委托模式在Cocos2d-x中的应用。

我很欣赏你这样的人:12::12::12:

不知 curl 方面的知识的教程可否多介绍些, 上传 ,下载,cppTest 里的 例子有点少,可否多介绍些!

star特530 写的教程质量赞一下,真心不错。

这里有2篇,http://www.cocos2d-x.org/wiki/Network

确实这方面的文档和教程会比较少,接下来会尽量加强这方面的。

而且有个问题是,第三方库的使用和引擎其实关系并不是很大。你在其他地方怎么用,在引擎基本上也是怎么用,比较普适。而第三方库一般都会有自己的官方指南。在当前情况下,建议多阅读这些指南,结合到Cocos2d-x中使用。

我很欣赏你这句话 :14:

你好。
请问:void CoolStar::scrollViewDidScroll(MyScrollView* view)
{
CCLOG(“star is so cool”);
}
这个函数是干什么用的,它虽然调用了这个函数,但这个函数并没有什么执行功能啊!

我是来顶贴的。
DAY DAY UP!:2:

scrollView 每拖动的时候都会调用到这个函数

感谢楼主分享 很实用的教材 感激感激

看完真心明白了

:2: :2: :2: :2: :2: :2:

star哥你好,请问CoolStar类在哪里new出来?

赞一个:14:

问下 cocos2dx3.x tableview 自带多选功能吗 如果没有的话大概应该如何实现呢

谢谢啊~~~~~~~~~~~~~~~~~~~~~~~~·

谢谢你的回复,
我的意思是这个函数并没有实质性的内容,
是不是仅仅是留下这个接口,以让开发者实现其它的用途。
但就控件本身来说,暂时是没用的。

除此之外,再请教你一个问题,是我在开发中遇到的。
我用的 scrollView过种程中,单手指拖动是没有问题的,触摸事件也不会穿透到下面的按钮中去。
但当我用一个手指按住scrollView不放,另一个手指再点击的时候,有两个意外情况发生。

  1. 事件会穿透到本层下面的按钮中去。
  2. scrollView显示的内容会消失掉(这里我怀疑是偏移量的问题,但不知道是如何引发的)
    谢谢!

不明觉厉!!!!!!:3:

受益,感谢!:4: