cocos代码研究(11)ActionManager类学习笔记
理论部分
ActionManager是一个单例类,管理所有动作。 通常你不需要直接使用这个类。大多情况下,你将使用Node的接口,它提供了更友好的封装 但也有一些情况下,你可能需要使用这个单例。 示例:
- 当你想要运行一个动作,但目标不是节点类型。
- 当你想要暂停/恢复动作。
代码部分
void addAction (Action *action, Node *target, bool paused)
增加一个动作,同时还需要提供动作的目标对象,目标对象是否暂停作为参数。当目标状态paused为true,动作将不会被执行。
实例:
auto director = Director::getInstance(); director->getActionManager()->addAction(action, grossini, true);
void removeAllActions ()
删除所有目标对象的所有动作。
void removeAllActionsFromTarget (Node *target)
从一个特定的目标删除所有动作。 属于该目标的所有的动作将被删除。
void removeAction (Action *action)
删除一个动作。
void removeActionByTag (int tag, Node *target)
删除目标对象下特定标签标记的一个动作,将删除首个匹配到的动作。
void removeAllActionsByTag (int tag, Node *target)
删除目标对象下特定标签标记的所有动作。
void removeActionsByFlags (unsigned int flags, Node *target)
删除目标对象下特定标记组动作
Action * getActionByTag (int tag, const Node *target) const
通过目标对象和标签获取一个动作。
ssize_t getNumberOfRunningActionsInTarget (const Node *target) const
返回指定目标下所有正在运行的动作数量。 组合动作被算作一个动作。例子:
ssize_t numberOfRunningActionsInTarget (Node *target) const
void pauseTarget (Node *target)
暂停目标对象:所有正在运行的动作和新添加的动作都将会暂停。
void resumeTarget (Node *target)
让目标对象恢复运行。在执行序列中所有被暂停的动作将重新恢复运行。
实例:
auto director = Director::getInstance();
director->getActionManager()->resumeTarget(node);
Vector< Node * > pauseAllRunningActions ()
暂停所有正在运行的动作,返回一个动作被暂停的目标对象列表。
void resumeTargets (const Vector< Node * > &targetsToResume)
让一组目标对象恢复运行。