首页 > 代码库 > cocos2d-x实战 C++卷 学习笔记--第4章 使用菜单
cocos2d-x实战 C++卷 学习笔记--第4章 使用菜单
前言:
菜单中包含菜单项,菜单项类是 MenuItem ,每个菜单项都有三个基本状态:正常、选中和禁止。
(MenuItem)菜单分类:
- (文本菜单)MenuItemLabel : MenuItemAtlasFont, MenuItemFont
- (精灵菜单)MenuItemSprite : MenuItemImage
- (开关菜单)MenuItemToggle
文本菜单
文本菜单是 菜单项 只能显示文本,文本菜单类包括 MenuItemLabel、MenuItemFont 和 MenuItemAtlasFont。
MenuItemLabel 是个抽象类,具体使用的时候是使用 MenuItemFont, MenuItemAtlasFont。
MenuItemFont 其中的一个 创建函数 create 如下:
1 static MenuItemFont * create(const std::string& value, /// 要显示的文本2 const ccMenuCallback& callback); /// 菜单操作的回调函数指针
MenuItemAltasFont 是基于 图片集 的文本菜单项,它的其中一个 创建函数 create 如下:
1 static MenuItemAtlasFont* create(const std::string& value, /// 要显示的文本2 const std::string& charMapFile, /// 图片集文件 3 int itemWidth, /// 要截取的文字在图片中的 宽度4 int itemHeight, /// 要截取的文字在图片中的 高度5 char startCharMap, /// 开始字符6 const ccMenuCallback& callback); /// 菜单操作的 回调函数 指针
文本菜单 代码示例:
1 MenuItemFont::setFontName("Times New Roman"); 2 MenuItemFont::setFontSize(86); 3 MenuItemFont* item1 = MenuItemFont::create("Start", 4 CC_CALLBACK_1(HelloWorld::menuItemCallback_start, this));///item1坐标没有显示设置,默认是mn的坐标 5 MenuItemAtlasFont* item2 = MenuItemAtlasFont::create("Help", 6 "menu/tuffy_bold_italic-charmap.png", 7 48, 8 65, 9 ‘ ‘, 10 CC_CALLBACK_1(HelloWorld::menuItemCallback_help, this));11 item2->setPosition(Point(500, 300));12 Menu* mn = Menu::create(item1, item2, NULL);13 //mn->alignItemsVertically();14 ///mn->setAnchorPoint(ccp(0, 0)); // 设置锚点 没用15 mn->setPosition(Point(200, 100));16 this->addChild(mn); /// 把菜单对象添加到 当前层 中17 18 19 void HelloWorld::menuItemCallback_start(cocos2d::Ref* pSender)20 {21 MenuItem* item = (MenuItem*)pSender;22 log("Touch Start Menu item %p", item);23 }24 25 void HelloWorld::menuItemCallback_help(cocos2d::Ref* pSender)26 {27 MenuItem* item = (MenuItem*)pSender;28 log("Touch Help Menu item %p", item);29 }
精灵菜单和图片菜单
精灵菜单的 菜单项类是 MenuItemSprite
图片菜单的 菜单项类是 MenuItemImage
由于 MenuItemImage 继承于 MenuItemSprite,所以图片菜单也属于精灵菜单。
精灵菜单类 MenuItemSprite,它的其中一个创建函数 create 定义如下:
1 static MenuItemSprite * create(Node* normalSprite, /// 菜单项正常显示时的精灵2 Node* selectedSprite, /// 选择菜单项时的 精灵3 Node* disabledSprite, /// 菜单项 禁用时的 精灵.MenuItemSprite有一些create函数,disabledSprite参数可省略.4 const ccMenuCallback& callback); /// 菜单操作的 回调函数 指针
图片菜单类 MenuItemImage,它的其中一个创建函数 create 定义如下:
1 static MenuItemImage* create(const std::string&normalImage, /// 菜单项 正常显示时的 图片2 const std::string&selectedImage, /// 选择 菜单项 时的图片3 const std::string&disabledImage, /// 菜单项 禁用 时的图片.4 const ccMenuCallback& callback); /// 菜单操作的 回调函数 指针
精灵菜单和图片菜单 代码示例:
1 /// "开始" 精灵菜单项 2 Sprite* startSpNormal = Sprite::create("menu/start-up.png"); 3 Sprite* startSpSelected = Sprite::create("menu/start-down.png"); 4 MenuItemSprite* startMenuItem = MenuItemSprite::create(startSpNormal, 5 startSpSelected, 6 CC_CALLBACK_1(HelloWorld::menuItemCallback_start2, this)); 7 startMenuItem->setPosition(Director::getInstance()->convertToGL(Point(700, 170))); 8 9 // "设置" 图片菜单项10 MenuItemImage* settingMenuItem = MenuItemImage::create("menu/setting-up.png", 11 "menu/setting-down.png", 12 CC_CALLBACK_1(HelloWorld::menuItemCallback_setting2, this));13 settingMenuItem->setPosition(Director::getInstance()->convertToGL(Point(480, 400)));14 15 16 // "帮助" 图片菜单项17 MenuItemImage* helpMenuItem = MenuItemImage::create("menu/help-up.png",18 "menu/help-down.png",19 CC_CALLBACK_1(HelloWorld::menuItemCallback_help2, this));20 helpMenuItem->setPosition(Director::getInstance()->convertToGL(Point(860, 480)));21 22 Menu* mu2 = Menu::create(startMenuItem, settingMenuItem, helpMenuItem, NULL);23 mu2->setPosition(Point(-200,-100));24 this->addChild(mu2);
1 void HelloWorld::menuItemCallback_start2(cocos2d::Ref* pSender) //// 定义若干回调函数 2 { 3 MenuItem* item = (MenuItem*)pSender; 4 log("Touch menuItemCallback_start2 %p", item); 5 } 6 7 void HelloWorld::menuItemCallback_setting2(cocos2d::Ref* pSender) 8 { 9 MenuItem* item = (MenuItem*)pSender;10 log("Touch menuItemCallback_setting2 %p", item);11 }12 13 void HelloWorld::menuItemCallback_help2(cocos2d::Ref* pSender)14 {15 MenuItem* item = (MenuItem*)pSender;16 log("Touch menuItemCallback_help2 %p", item);17 }
注意:
1.掌握类的正确使用;
2.坐标转换
startMenuItem->setPosition(Director::getInstance()->convertToGL(Point(700, 170)));
UI坐标系 原点是 左上角,OpenGL坐标系原点是 左下角。
将UI坐标系中的(700, 170)坐标转换为OpenGL坐标系中的坐标就是(700, Height-170)。Height是屏幕高度。
3.相对坐标位置
mu2->setPosition(Point(X1, Y1));
startMenuItem->setPosition(Point(X2, Y2));
此处暂且忽略坐标系的不同。
mu2设置在 以左下角为原点,(X1, Y1)的坐标位置;
startMenuItem 设置在 以mu2坐标为原点,(X2, Y2)的坐标位置。
那么,startMenuItem相对于 左下角 的坐标位置,其实是(X2-X1, Y2-Y1)。
因为 startMenuItem 是 mu2菜单 的 菜单项,因此他们有这个 相对坐标关系。
开关菜单
开关菜单的 菜单项 是 MenuItemToggle,它是一种可以进行两种(或两种以上)状态切换的菜单项。
它可通过下面的函数创建:
1 static MenuItemToggle* createWithCallback(2 const ccMenuCallback& callback, ///菜单操作的 回调函数 指针3 MenuItem* item, /// 进行切换的 菜单项4 ...5 ) CC_REQUIRES_NULL_TERMINATION; /// 这个函数的参数需要以 NULL 结尾
从第2个参数开始,都是MenuItem类的实例对象,它们是开关菜单显示的菜单项,它们可以是文本、图片、和精灵类型的菜单项。
下面代码是简单形式的 文本类型 的 开关菜单项
1 auto toggleMenuItem = MenuItemToggle::createWithCallback(2 CC_CALLBACK_1(HelloWorld::menuItemCallback_help, this),3 MenuItemFont::create("On"),4 MenuItemFont::create("Off"),5 NULL);
图片类型的开关菜单项
1 // 音效.... 此处没有粘贴回调函数的代码。回调函数的代码,可以参考上面介绍的回调函数。 2 auto soundOnMenuItem = MenuItemImage::create("menu3/on.png", "menu3/on.png"); 3 auto soundOffMenuItem = MenuItemImage::create("menu3/off.png", "menu3/off.png"); 4 auto soundToggleMenuItem = MenuItemToggle::createWithCallback( 5 CC_CALLBACK_1(HelloWorld::menuSoundToggleCallback, this), 6 soundOnMenuItem, 7 soundOffMenuItem, 8 NULL); 9 soundToggleMenuItem->setPosition(Director::getInstance()->convertToGL(Point(818, 220)));10 11 // 音乐12 auto musicOnMenuItem = MenuItemImage::create("menu3/on.png", "menu3/on.png");13 auto musicOffMenuItem = MenuItemImage::create("menu3/off.png", "menu3/off.png");14 auto musicOnMenuItem2 = MenuItemImage::create("menu3/on2.png", "menu3/on2.png");15 auto musicOffMenuItem2 = MenuItemImage::create("menu3/off2.png", "menu3/off2.png");16 17 auto musicToggleMenuItem = MenuItemToggle::createWithCallback(18 CC_CALLBACK_1(HelloWorld::menuMusicToggleCallback, this),19 musicOnMenuItem,20 musicOffMenuItem,21 musicOnMenuItem2, ///我故意多插入了几项。加载不同的图片,你就能看到效果了。22 musicOffMenuItem2, 23 NULL);24 musicToggleMenuItem->setPosition(Director::getInstance()->convertToGL(Point(816, 362)));25 26 // OK 按钮27 auto okMenuItem = MenuItemImage::create(28 "menu3/ok-down.png",29 "menu3/ok-up.png");30 okMenuItem->setPosition(Director::getInstance()->convertToGL(Point(600, 510)));31 32 Menu* mn3 = Menu::create(soundToggleMenuItem, musicToggleMenuItem, okMenuItem, NULL);33 /// 菜单设置在了(0,0),但是 它的菜单项,在setposition的时候,是相对于此处的 mu3设置的34 mn3->setPosition(Point::ZERO); 35 this->addChild(mn3, 3);
cocos2d-x实战 C++卷 学习笔记--第4章 使用菜单