Layer是处理玩家事件响应的Node子类。与场景不同,层通常包含的是直接在屏幕上呈现的内容,并且可以接受用户的输入事件,包括触摸、键盘输入等。我们需要在层中加入Sprite(精灵)、文本标签或者其它游戏元素,并设置游戏元素的属性,比如位置、方向和大小;设置游戏元素的动作等。在我们设计好层以后,只需要把层按照顺序添加到场景中就可以显示出来了。一个场景中有多个可以交互的图层,每层显示不同的角色信息。Layer层一方面作为容器使用,另一方面处理相关事件的响应(如触摸点击、用户输入等等…)。
类关系
父类:
- Layer类是Node类的一个子类,它实现了触屏事件代理(TouchEventsDelegate)协议。
- LayerColor是Layer的一个子类,它实现了RGBAProtocol协议。
- LayerGradient是LayerColor的一个子类,它在背景上画渐变效果。LayerGradient它实现了LayerColor类的所有功能,还添加了以下这些新功能:渐变方向、渐变最终颜色、插值模式。
- LayerMultiplex类是一个能够使它的子类进行复用的布景层类。
常用方法
//初始化函数 virtual bool init(); //分配内存,默认创建一个全屏的黑色布景层 static Layer *create(void); //层进入回调 virtual void onEnter(); //层退出回调 virtual void onExit(); //如果层进入伴随转换效果,效果完成时回调 virtual void onEnterTransitionDidFinish(); //触摸事件(单点) virtual bool onTouchBegan(Touch *touch,Event *unused_event); virtual void onTouchMoved(Touch *touch,Event *unused_event); virtual void onTouchEnded(Touch *touch,Event *unused_event); virtual void onTouchCancelled(Touch *touch,Event *unused_event); //触摸事件(单点和多点) virtual void onTouchesBegan(const std::vector<Touch*>& touches,Event *unused_event); virtual void onTouchesMoved(const std::vector<Touch*>& touches,Event *unused_event); virtual void onTouchesEnded(const std::vector<Touch*>& touches,Event *unused_event); virtual void onTouchesCancelled(const std::vector<Touch*>&touches,Event *unused_event); //注册触摸分发,默认是addStandardDelegate virtual void registerWithTouchDispatcher(void); //判断触屏事件是否开启 bool isTouchEnabled(); //开启或关闭触屏事件 void setTouchEnabled(bool value); //设置/获取触摸模式 void setTouchMode(Touch::DispatchMode mode) Touch::DispatchMode getTouchMode(); //触屏事件中的 swallowsTouches 事件。默认是true. void setSwallowsTouches(bool swallowsTouches); bool isSwallowsTouches() const; //设置/获取是否接收键盘事件 bool isKeypadEnabled(); void setKeypadEnabled(bool value); //返回键和菜单键的回调,需要设置接收键盘事件 void keyBackClicked(void); void keyMenuClicked(void);