CCTouchDelegateProtocol(CCTouchDelegate触摸事件委托 两子类：1CCTargetedTouchDelegate,2CCStandardTouchDelegate)

#ifndef __TOUCH_DISPATHCHER_CCTOUCH_DELEGATE_PROTOCOL_H__

#define __TOUCH_DISPATHCHER_CCTOUCH_DELEGATE_PROTOCOL_H__

#include "cocoa/CCObject.h"

#include "ccConfig.h"

NS_CC_BEGIN

class CCTouch;

class CCEvent;

class CCSet;

class CCTouchDispatcher;

class CC_DLL CCTouchDelegate  //触摸事件委托，就是系统捕捉到触摸事件后交由它或者它的子类处理，所以我们在处理触屏事件时，必须得继承它

{

public:

    CCTouchDelegate() {}

    virtual ~CCTouchDelegate(){}

//单点触摸 子类重写回调

    virtual bool ccTouchBegan(CCTouch *pTouch, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent); return false;};

//optional（可选择的，随意的） 

   virtual void ccTouchMoved(CCTouch *pTouch, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent);}

    virtual void ccTouchEnded(CCTouch *pTouch, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent);}

    virtual void ccTouchCancelled(CCTouch *pTouch, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent);}

//多点触摸 子类重写回调 optional（可选择的，随意的）

     virtual void ccTouchesBegan(CCSet *pTouches, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}

     virtual void ccTouchesMoved(CCSet *pTouches, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}

     virtual void ccTouchesEnded(CCSet *pTouches, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}

     virtual void ccTouchesCancelled(CCSet *pTouches, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}

};

/**

 @brief

 Using this type of delegate results in two benefits（福利 收益）:

 - 1. You don't need to deal with CCSets, the dispatcher does the job of splitting（split 分解 分离）

 them. You get exactly one UITouch per call.

 - 2. You can *claim*（要求；声称；） a UITouch by returning YES in ccTouchBegan（声明一个触摸的开始通过在cctouchbegan返回true）. Updates of claimed

 touches are sent only to the delegate(s) that claimed them. So if you get a move/

 ended/canceled update you're sure it's your touch. This frees you from doing a

 lot of checks when doing multi-touch（多点触摸）. 

/

Cocos2d用CCTouchDispatcher类分发从IOS获取的触摸事件。它有两种分发方式一种是CCStandardTouchDelegate，一种是CCTargetedTouchDelegate。前者将所有的Touch信息直接传递给实现该协议的对象(CCStandardTouchDelegate)，而后者则要求实现该代理的类一次只能处理一个事件，并且吃掉该事件，不再传播(CCTargetedTouchDelegate)。
     所以CCTargetedTouchDelegate这个协议针对单点触控，而CCStandardTouchDelegate则可以处理当前屏幕触摸的每个触摸点，好像最多是十个吧。CCLayer默认情况下如果设定接受Touch事件，是使用标准协议。

    我们可以看到，在注册协议的时候分别对应这样的方式：

-(void) addStandardDelegate:(id<CCStandardTouchDelegate>) delegate priority:(int)priority;

 

-(void) addTargetedDelegate:(id<CCTargetedTouchDelegate>) delegate priority:(int)priority swallowsTouches:(BOOL)swallowsTouches;

      他们的区别在swallowsTouches参数，它表示是否吃掉该事件，而且只在目标协议里有意义。我们来分析各个协议的工作机理：

      Standard这套协议，他会按照优先级给每个层排序。然后把touch按照顺序分别传进去，也就是说从上到下的所有层 只要开启了self.istouchenabled = YES 那么他们都会收到touch，而且不可以吃掉该事件。测试显示即使上面一层相应了该事件，它仍然会传递到下一层。

      targeted这套协议只支持单点触控，即使是多点触控也当单点触控来用，但是返回的UITouch 就不知道是哪个了。他的好处是有swallow选项，即可判断是否继续传递 touch，而且，他的cctouchbegan函数是个bool值，如果你不返回一个yes的话，后面的 move 和 ended 都不会执行，如果要使用该协议，要在layer中手动设定代理：addStandardDelegate。因为CCLayer内部只注册标准代理。

      我们的问题就来了，Standard协议无法吃掉事件，也许多个层都会相应的时候会出问题，而研究target协议实现的源码，也可以发现其实吃掉一个事件很简单，只要在Touch的集合中执行removeObject方法即可。

     CCMenu继承了CCLayer，但是它注册的是targeted协议,所以我们很少发现CCMenu的混乱，因为它会将touch吃掉。

     另外，CCTouchDispatcher中对两个协议的分配是有先后顺序的，首先会把事件传递给实现Target的代理，然后才是Stardard的代理。

//

 (The name TargetedTouchDelegate relates to（涉及 有关） updates "targeting" their specific

 handler, without bothering（烦扰） the other handlers.)

 @since v0.8

 */

 class CC_DLL CCTargetedTouchDelegate : public CCTouchDelegate

 {

 public:

     /** Return YES to claim the touch.

      @since v0

     */

     virtual bool ccTouchBegan(CCTouch *pTouch, CCEvent *pEvent) { CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent);return false;};

 

     // optional（可选择的，随意的）

     virtual void ccTouchMoved(CCTouch *pTouch, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent);}

     virtual void ccTouchEnded(CCTouch *pTouch, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent);}

     virtual void ccTouchCancelled(CCTouch *pTouch, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent);}

 };

 

/** @brief

 This type of delegate is the same one used by CocoaTouch. You will receive(接收) all the events (Began,Moved,Ended,Canceled).

 @since v0.8

 */

 class CC_DLL CCStandardTouchDelegate : public CCTouchDelegate

 {

 public:

     // optional

     virtual void ccTouchesBegan(CCSet *pTouches, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}

     virtual void ccTouchesMoved(CCSet *pTouches, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}

     virtual void ccTouchesEnded(CCSet *pTouches, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}

    virtual void ccTouchesCancelled(CCSet *pTouches, CCEvent *pEvent) {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}

 };

NS_CC_END

#endif