文本菜单是菜单项只是显示文本,文本菜单类包括了MenuItemLabel、MenuItemFont和MenuItemAtlasFont。MenuItemLabel是个抽象类,具体使用的时候是使用MenuItemFont和MenuItemAtlasFont两个类。
文本菜单类MenuItemFont,它的其中一个创建函数create定义如下:
- static MenultemAtlasFont*create ( const std::string & value, //要显示的文本
- const ccMenuCallback & callback //菜单操作的回调函数指针
- )
文本菜单类MenuItemAtlasFont是基于图片集的文本菜单项,它的其中一个创建函数create定义如下:
- static MenuItemAtlasFont* create ( const std::string & value, //要显示的文本
- const std::string & charMapFile, //图片集合文件
- int itemWidth, //要截取的文字在图片中的宽度
- int itemHeight, //要截取的文字在图片中的高度
- char startCharMap //菜单操作的回调函数指针
- )
这次我们会通过一个实例介绍一下文本菜单的使用,这个实例如下图所示,其中菜单Start是使用MenuItemFont实现的,菜单Help是使用MenuItemAtlasFont实现的。
下面我们看看HelloWorldScene.cpp中init函数如下:
- bool HelloWorld::init()
- {
- if ( !Layer::init() )
- {
- return false;
- }
- Size visibleSize = Director::getInstance()->getVisibleSize();
- Point origin = Director::getInstance()->getVisibleOrigin();
- Sprite *bg =Sprite::create("menu/background.png");
- bg->setPosition(Point(origin.x + visibleSize.width/2,
- origin.y +visibleSize.height /2));
- this->addChild(bg);
- MenuItemFont::setFontName("Times New Roman"); ①
- MenuItemFont::setFontSize(86); ②
- MenuItemFont *item1 = MenuItemFont::create("Start",
- CC_CALLBACK_1(HelloWorld::menuItem1Callback,this)); ③
- MenuItemAtlasFont *item2 = MenuItemAtlasFont::create("Help",
- "menu/tuffy_bold_italic-charmap.png",48, 65, ' ',
- CC_CALLBACK_1(HelloWorld::menuItem2Callback,this)); ④
- Menu* mn = Menu::create(item1, item2, NULL); ⑤
- mn->alignItemsVertically(); ⑥
- this->addChild(mn); ⑦
- return true;
- }
上述代码第①和②行是设置文本菜单的文本字体和字体大小。第③行代码是创建MenuItemFont菜单项对象,它是一个一般文本菜单,create是函数的第一个参数是菜单项的文本内容,第二个参数是点击菜单项回调的函数指针。其中CC_CALLBACK_1宏是定义一个回调函数,并函数与对象绑定在一起,1表示这个函数有一个输出参数,HelloWorld::menuItem1Callback是函数指针,this代表函数所在的对象。
HelloWorld::menuItem1Callback需要在HelloWorld.h头文件中声明,HelloWorld.h头文件代码如下:
- #include "cocos2d.h"
- class HelloWorld : public cocos2d::Layer
- {
- public:
- virtual bool init();
- static cocos2d::Scene* scene();
- void menuItem1Callback(cocos2d::Ref*pSender);
- void menuItem2Callback(cocos2d::Ref*pSender);
- CREATE_FUNC(HelloWorld);
- };
回调函数代码如下,函数中的参数是菜单项MenuItem的实例。
- void HelloWorld::menuItem1Callback(Ref*pSender)
- {
- MenuItem* item = (MenuItem*)pSender;
- log("TouchStart Menu Item %p", item);
- }
- void HelloWorld::menuItem2Callback(Ref*pSender)
- {
- MenuItem* item = (MenuItem*)pSender;
- log("TouchHelp Menu Item %p", item);
- }
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)是把菜单对象添加到当前层中。