cocos2d-x中false，setSwallowTouches，stopPropagation的区别
研究到cocos2d-x触摸这一块了，3.0和2.0相比已经有了很大的不同，使用更加方便和容易理解了。
直接进入正题，解释下，标题中3个用法的区别
通常来说，应用程序中更多使用的是单点触摸，为了简化单点触摸的处理，cocos2dx将一个触摸事件分为单点触摸和多点触摸两种类型，相应的对应单点和多点两种订阅者类型
EventListenerTouchAllAtOnce分为四种状态，开始触摸，移动，结束，取消，
每一个状态的回调函数都包含当前所有处于该种状态的触摸点，开发者需要使用触摸点的ID来区分每一个触摸点
EventListenerTouchOneByOne则相反，他将触摸某个状态的多个触摸点分为多次事件通知 ，他也分为四种状态，开始触摸，移动，结束，取消。
不同的地方是他的开始触摸方法 onTouchBegan返回值为bool，并且onTouchBegan是必须实现的，否则将收不到任何触摸事件通知，而EventListenerTouchAllAtOnce的onTouchBegan没有返回值，他的实现与否不影响后续状态的回调。
下面就牵扯到了返回true与false的问题。
onTouchBegan的返回值用来告诉EventDispatcher是否应该讲触摸点后续的触摸状态传递给订阅者。如果为false，onTouchMoved
onTouchEnded和onTouchCancelled，将接受不到任何回调。
但是注意的是，这个返回值只对当前订阅者有效，对后续订阅者的回调是控制不了的。比如
Node A 订阅了 EventListenerTouchOneByOne和 EventListenerTouchAllAtOnce两种触摸类型，前者的onTouchBegan返回false，那么当点击了NodeA的时候(就是一点一抬，不涉及移动)，触发了点击事件，那么执行的顺序为这个
1 EventListenerTouchOneByOne:onTouchBegan
2EventListenerTouchAllAtOnce:onTouchBegan
3EventListenerTouchAllAtOnce:onTouchEnd,
说明false只控制了EventListenerTouchOneByOne类型的订阅，对于Node订阅的EventListenerTouchAllAtOnce类型，控制不了，该怎么走还是怎么走。
再比如：
NodeA订阅了EventListenerTouchOneByOne，NodeB也订阅了EventListenerTouchOneByOne，并且NodeA的localZ小于NodeB的localZ，NodeA的onTouchBegan返回false，NodeB的onTouchBegan返回true，当触发点击事件之后，执行顺序为
1 NodeA EventListenerTouchOneByOne:onTouchBegan
2 NodeB EventListenerTouchOneByOne:onTouchBegan
3 NodeB EventListenerTouchOneByOne:onTouchEnd
说明NodeA的false只对订阅者nodeA起作用，对NodeB不起作用
这就是false的用法，如果想让当前订阅者继续往后面的状态传递，就返回true，不想让其传递，就返回false。
这种情况一般用在比如你点击了屏幕，但是坐标并没有落在某个sprite的可显示区域的上面，那么就返回false，反之返回true。比如下面得代码
bool isPointInNode(Vec2 pt, Node* node) { Vec2 locationInNode = node->convertToNodeSpace(pt); cocos2d::Size s = node->getContentSize(); cocos2d::Rect rect = cocos2d::Rect(0, 0, s.width, s.height); if (rect.containsPoint(locationInNode)) { return true; } return false; } touchOneByOneListener->onTouchBegan = [&](Touch* touch, Event* event){ auto target = static_cast<Sprite*>(event->getCurrentTarget()); if (this->isPointInNode(touch->getLocation(), target)) { target->setOpacity(180); return true; } return false; };
下面再说说setSwallowTouches的作用
当我们希望阻止一个触摸点向后面的订阅者继续分发，那么可以使用setSwallowTouches(true)来实现。
注意，swallowTouches设置需要在onTouchBegan返回true的时候才有效.
例如Sprite 和Sprite2都加到了同一个Node上，SpriteA后加，也就是SpriteA会先收到触摸事件，他们都订阅了EventListenerTouchOneByOne和
EventListenerTouchAllAtOnce
，如下代码
static const int TAG_BLUE_SPRITE = 101; static const int TAG_BLUE_SPRITE2 = 102; auto touchOneByOneListener = EventListenerTouchOneByOne::create(); touchOneByOneListener->setSwallowTouches(true); touchOneByOneListener->onTouchBegan = [&](Touch* touch, Event* event){ return true; }; touchOneByOneListener->onTouchEnded = [](Touch* touch, Event* event){ auto target = static_cast<Sprite*>(event->getCurrentTarget()); target->setOpacity(255); }; auto touchAllAtOnceListener = EventListenerTouchAllAtOnce::create(); touchAllAtOnceListener->onTouchesBegan = [=](const std::vector<Touch*>& touches, Event* event){ }; touchAllAtOnceListener->onTouchesEnded = [=](const std::vector<Touch*>& touches, Event* event){ }; Sprite* sprite; Sprite* sprite2; sprite = Sprite::create("CyanSquare.png"); sprite->setTag(TAG_BLUE_SPRITE); addChild(sprite, 100); sprite2 = Sprite::create("YellowSquare.png"); sprite2->setTag(TAG_BLUE_SPRITE2); addChild(sprite2, 100); _eventDispatcher->addEventListenerWithSceneGraphPriority(touchOneByOneListener->clone(), sprite); _eventDispatcher->addEventListenerWithSceneGraphPriority(touchAllAtOnceListener->clone(), sprite); _eventDispatcher->addEventListenerWithSceneGraphPriority(touchOneByOneListener->clone(), sprite2); _eventDispatcher->addEventListenerWithSceneGraphPriority(touchAllAtOnceListener->clone(), sprite2); sprite->setPosition(100,200); sprite2->setPosition(50,200);
注意我们设置 touchOneByOneListener->setSwallowTouches(true);
默认是false，通过设置了true，那么就可以阻止一个触摸点继续向后面的订阅者继续分发，
当点击事件触发后，执行顺序如下
1 spriteA touchOneByOneListener->onTouchBegan
2 spriteA touchOneByOneListener->onTouchEnd
因为spriteA的touchOneByOneListener->setSwallowTouches(true);他会阻止此后所有事件的分发，无论是spriteA自己的订阅类型EventListenerTouchAllAtOnce以及SpriteB的所有订阅类型。
这里说的一个应用的地方比如，spriteA订阅了单点触摸和多点触摸，但是他只想进行单点触摸的回调，而不想进行多点触摸的回调，那么就可以设置ontouchbegin返回true，并设置setSwallowTouches(true)，这样就可以阻止多点触摸事件的分发。
最后说的是stopPropagation，他和setSwallowTouches类似，也是阻止触摸点后面订阅者的事件分发，但是不同的是setSwallowTouches阻止的很彻底，他会阻止后面所有状态的分发，began，end，cancelled，moved，并且必须ontouchbegan返回true才会起作用，而stopPropagation只是阻止某个状态的分发，比如move状态等。
stopPropagation只是停止当前当次触摸状态下的所有分发，例如Moved状态会触发多次，则第二次不受前一次的影响。某个状态也不会影响另一个状态的分发，例如move不影响end状态的分发，所有这些只需要明白，每个状态每次分发都是一次独立的事件通知
举例子如下：
static const int TAG_BLUE_SPRITE = 101; static const int TAG_BLUE_SPRITE2 = 102; auto touchOneByOneListener = EventListenerTouchOneByOne::create(); touchOneByOneListener->setSwallowTouches(false); touchOneByOneListener->onTouchBegan = [&](Touch* touch, Event* event){ auto target = static_cast<Sprite*>(event->getCurrentTarget()); if(target->getTag() == TAG_BLUE_SPRITE2) { printf("sprite2单点触摸--ontouchbegan\n"); } else{ printf("sprite单点触摸--ontouchbegan\n"); } // event->stopPropagation(); return true; }; touchOneByOneListener->onTouchEnded = [](Touch* touch, Event* event){ auto target = static_cast<Sprite*>(event->getCurrentTarget()); if(target->getTag() == TAG_BLUE_SPRITE2) { printf("sprite2单点触摸--ontouchend\n"); } else{ printf("sprite单点触摸--ontouchend\n"); } }; auto touchAllAtOnceListener = EventListenerTouchAllAtOnce::create(); touchAllAtOnceListener->onTouchesBegan = [=](const std::vector<Touch*>& touches, Event* event){ auto target = static_cast<Sprite*>(event->getCurrentTarget()); if(target->getTag() == TAG_BLUE_SPRITE2) { printf("sprite2多点触摸--ontouchbegan\n"); } else{ printf("sprite多点触摸--ontouchbegan\n"); } }; touchAllAtOnceListener->onTouchesEnded = [=](const std::vector<Touch*>& touches, Event* event){ auto target = static_cast<Sprite*>(event->getCurrentTarget()); if(target->getTag() == TAG_BLUE_SPRITE2) { printf("sprite2多点触摸--ontouchend\n"); } else{ printf("sprite多点触摸--ontouchend\n"); } }; Sprite* sprite; Sprite* sprite2; sprite = Sprite::create("CyanSquare.png"); sprite->setTag(TAG_BLUE_SPRITE); addChild(sprite, 100); sprite2 = Sprite::create("YellowSquare.png"); sprite2->setTag(TAG_BLUE_SPRITE2); addChild(sprite2, 100); _eventDispatcher->addEventListenerWithSceneGraphPriority(touchOneByOneListener->clone(), sprite); _eventDispatcher->addEventListenerWithSceneGraphPriority(touchAllAtOnceListener->clone(), sprite); _eventDispatcher->addEventListenerWithSceneGraphPriority(touchOneByOneListener->clone(), sprite2); _eventDispatcher->addEventListenerWithSceneGraphPriority(touchAllAtOnceListener->clone(), sprite2); sprite->setPosition(100,200); sprite2->setPosition(50,200);
执行代码结果如下
sprite2单点触摸--ontouchbegan
sprite单点触摸--ontouchbegan
sprite2多点触摸--ontouchbegan
sprite多点触摸--ontouchbegan
sprite2单点触摸--ontouchend
sprite单点触摸--ontouchend
sprite2多点触摸--ontouchend
sprite多点触摸--ontouchend
这个结果很容易理解，就是没有阻止事件的分发，一切都是按计划进行
如果 event->stopPropagation()的注释去掉，那么执行结果如下：
sprite2单点触摸--ontouchbegan
sprite2单点触摸--ontouchend
sprite2多点触摸--ontouchend
sprite多点触摸--ontouchend
这个的解释为：
sprite2的touchbegan先回调，然后stopprpagation，之后关于touchbegan的状态的事件分发就会停止，也就是sprite的touchbegan不会执行了，
而sprite的单点触摸的touchbegan不执行，那么sprite的单点触摸的其余状态也不会执行，但是sprite的多点触摸的touchbegan不执行，不影响多点触摸的其他状态的执行，所以sprite就执行了一个多点触摸的ontouchend
以上就是对这三种用法的简单解释，如果需要查看其工作原理，还是要深入到源码中，进行了解。
