Cocos2d-x文本菜单

时间:2023-03-09 16:16:27
Cocos2d-x文本菜单

文本菜单是菜单项只是显示文本,文本菜单类包括了MenuItemLabel、MenuItemFont和MenuItemAtlasFont。MenuItemLabel是个抽象类,具体使用的时候是使用MenuItemFont和MenuItemAtlasFont两个类。

文本菜单类MenuItemFont,它的其中一个创建函数create定义如下:

  1. static MenultemAtlasFont*create  ( const std::string &  value, //要显示的文本
  2. const ccMenuCallback & callback                             //菜单操作的回调函数指针
  3. )

文本菜单类MenuItemAtlasFont是基于图片集的文本菜单项,它的其中一个创建函数create定义如下:

  1. static MenuItemAtlasFont* create  ( const std::string &  value, //要显示的文本
  2. const std::string & charMapFile,                                         //图片集合文件
  3. int  itemWidth,                                                                       //要截取的文字在图片中的宽度
  4. int  itemHeight,                                                             //要截取的文字在图片中的高度
  5. char  startCharMap                                                      //菜单操作的回调函数指针
  6. )

这次我们会通过一个实例介绍一下文本菜单的使用,这个实例如下图所示,其中菜单Start是使用MenuItemFont实现的,菜单Help是使用MenuItemAtlasFont实现的。

Cocos2d-x文本菜单

下面我们看看HelloWorldScene.cpp中init函数如下:

  1. bool HelloWorld::init()
  2. {
  3. if ( !Layer::init() )
  4. {
  5. return false;
  6. }
  7. Size visibleSize = Director::getInstance()->getVisibleSize();
  8. Point origin = Director::getInstance()->getVisibleOrigin();
  9. Sprite *bg =Sprite::create("menu/background.png");
  10. bg->setPosition(Point(origin.x + visibleSize.width/2,
  11. origin.y +visibleSize.height /2));
  12. this->addChild(bg);
  13. MenuItemFont::setFontName("Times New Roman");                                                       ①
  14. MenuItemFont::setFontSize(86);                                                                                      ②
  15. MenuItemFont *item1 = MenuItemFont::create("Start",
  16. CC_CALLBACK_1(HelloWorld::menuItem1Callback,this));                             ③
  17. MenuItemAtlasFont *item2 = MenuItemAtlasFont::create("Help",
  18. "menu/tuffy_bold_italic-charmap.png",48, 65, ' ',
  19. CC_CALLBACK_1(HelloWorld::menuItem2Callback,this));                         ④
  20. Menu* mn = Menu::create(item1, item2, NULL);                                                                         ⑤
  21. mn->alignItemsVertically();                                                                                               ⑥
  22. this->addChild(mn);                                                                                                         ⑦
  23. return true;
  24. }

上述代码第①和②行是设置文本菜单的文本字体和字体大小。第③行代码是创建MenuItemFont菜单项对象,它是一个一般文本菜单,create是函数的第一个参数是菜单项的文本内容,第二个参数是点击菜单项回调的函数指针。其中CC_CALLBACK_1宏是定义一个回调函数,并函数与对象绑定在一起,1表示这个函数有一个输出参数,HelloWorld::menuItem1Callback是函数指针,this代表函数所在的对象。

HelloWorld::menuItem1Callback需要在HelloWorld.h头文件中声明,HelloWorld.h头文件代码如下:

  1. #include "cocos2d.h"
  2. class HelloWorld : public cocos2d::Layer
  3. {
  4. public:
  5. virtual bool init();
  6. static cocos2d::Scene* scene();
  7. void menuItem1Callback(cocos2d::Ref*pSender);
  8. void menuItem2Callback(cocos2d::Ref*pSender);
  9. CREATE_FUNC(HelloWorld);
  10. };

回调函数代码如下,函数中的参数是菜单项MenuItem的实例。

  1. void HelloWorld::menuItem1Callback(Ref*pSender)
  2. {
  3. MenuItem* item = (MenuItem*)pSender;
  4. log("TouchStart Menu Item %p", item);
  5. }
  6. void HelloWorld::menuItem2Callback(Ref*pSender)
  7. {
  8. MenuItem* item = (MenuItem*)pSender;
  9. log("TouchHelp Menu Item %p", item);
  10. }

HelloWorldScene.cpp中init函数中第④行代码是创建一个MenuItemAtlasFont菜单项对象,这种菜单项是基于图片集的菜单项。MenuItemAtlasFont需要将图片集放到资源目录Resources下。在本例中我们是将所有的图片都放到一个Resources下的menu目录中,所以create函数的第二个参数是"menu/tuffy_bold_italic-charmap.png",要求带有menu路径。

还有第⑤行代码Menu* mn = Menu::create(item1, NULL)是创建菜单对象,把之前创建的菜单项添加到菜单中,create函数中有是这些菜单项的数组,最后要用NULL结束。第⑥行代码mn->alignItemsVertically()是设置菜单项垂直对齐。第⑦行代码是this->addChild(mn,1,2)是把菜单对象添加到当前层中。