一、UI 框架的使用方法以及常用接口介绍
1.cocos2d-x 使用UI框架的步骤:
1)cocos2d-x 导入cocoStudio的UI编辑器文件(json)
2)创建控件:绑定控件、编码创建控件
3)使用控件做逻辑处理:比如,按钮、listview、scrollview等等控件做响应事件。
注释: json 文件(由 ui 编辑器导出生成)来初始化一个 ui 系统,ui 系统 同样会清除当前 ui 系统中的控件,并初始化成 json 文件中描述的 ui 控件。
2.控件绑定:
这里举个例子,如图:
代码:
// equip root from json Layout* equipe_root =dynamic_cast<Layout*>(GUIReader::shareReader()->widgetFromJsonFile("cocosgui/gui_examples/equip_1/equip_1.json")); equipe_root->setTag(EQUIP_LAYOUT_TAG_ROOT); m_pUILayer->addWidget(equipe_root); // title layout Layout* title_layout = dynamic_cast<Layout*>(equipe_root->getChildByName("title_panel")); // close button UIButton* close_btn = dynamic_cast<UIButton*>(title_layout->getChildByName("close_button")); close_btn->setVisible(false);
接着就可以使用绑定的控件做事件处理。
注:这里要注意一点是,我使用的网上的样例,因cocos2d-x引擎版本不同,需要更改下代码,基本思路都是一样的。
3.编码创建控件:
举个创建层的例子,代码如下:
//UILayer层 m_pUiLayer = UILayer::create(); addChild(m_pUiLayer);
二、各个控件的使用方法
1.CocoButton
1.1 示例
1.2 实现代码
HelloWorldScene.cpp
m_pUiLayer = UILayer::create(); addChild(m_pUiLayer); m_pWidget = dynamic_cast<UILayout*>(GUIReader::shareReader()->widgetFromJsonFile("cocosgui/UITest/UITest.json")); //m_pUiLayer->addWidget(m_pWidget); CCSize widgetSize = m_pWidget->getSize(); //UILabel文字 m_pDisplayValueLabel = UILabel::create(); m_pDisplayValueLabel->setText("No Event"); m_pDisplayValueLabel->setFontName("Marker Felt"); m_pDisplayValueLabel->setAnchorPoint(ccp(0.5f, -1)); m_pDisplayValueLabel->setPosition(ccp(widgetSize.width / 2.0f, widgetSize.height / 1.5f)); m_pDisplayValueLabel->setColor(ccc3(159, 168, 176)); m_pUiLayer->addWidget(m_pDisplayValueLabel); //按钮 UIButton* button = UIButton::create(); button->setTouchEnabled(true); button->setScale9Enabled(true);//是否支持九宫 button->loadTextures("cocosgui/animationbuttonnormal.png", "cocosgui/animationbuttonpressed.png", ""); button->setPosition(ccp(widgetSize.width / 2.0f, widgetSize.height / 2.0f)); button->addTouchEventListener(this, toucheventselector(HelloWorld::touchEvent)); m_pUiLayer->addWidget(button);
点击事件
void HelloWorld::touchEvent(CCObject *pSender, TouchEventType type) { //按下、移动、结束、取消 switch (type) { case TOUCH_EVENT_BEGAN: m_pDisplayValueLabel->setText(CCString::createWithFormat("Touch Down")->getCString()); break; case TOUCH_EVENT_MOVED: m_pDisplayValueLabel->setText(CCString::createWithFormat("Touch Move")->getCString()); break; case TOUCH_EVENT_ENDED: m_pDisplayValueLabel->setText(CCString::createWithFormat("Touch Up")->getCString()); break; case TOUCH_EVENT_CANCELED: m_pDisplayValueLabel->setText(CCString::createWithFormat("Touch Cancelled")->getCString()); break; default: break; } }
2.UICheckBox
2.1 示例
2.2 代码
//单选按钮 UICheckBox* checkBox = UICheckBox::create(); checkBox->setTouchEnabled(true); checkBox->loadTextures("cocosgui/check_box_normal.png", "cocosgui/check_box_normal_press.png", "cocosgui/check_box_active.png", "cocosgui/check_box_normal_disable.png", "cocosgui/check_box_active_disable.png"); checkBox->setPosition(ccp(widgetSize.width / 2.0f, widgetSize.height / 2.0f)); checkBox->addEventListenerCheckBox(this, checkboxselectedeventselector(HelloWorld::selectedStateEvent)); m_pUiLayer->addWidget(checkBox);
响应事件
void HelloWorld::selectedStateEvent(CCObject* pSender, CheckBoxEventType type) { switch (type) { case CHECKBOX_STATE_EVENT_UNSELECTED://取消 m_pDisplayValueLabel->setText(CCString::createWithFormat("Unselected")->getCString()); break; case CHECKBOX_STATE_EVENT_SELECTED: //选中 m_pDisplayValueLabel->setText(CCString::createWithFormat("Selected")->getCString()); break; default: break; } }
3.CocoImageView
3.1 示例
3.2 代码:
UIImageView* imageView = UIImageView::create(); //imageView->setScale9Enabled(true); //是否支持九宫 imageView->loadTexture("cocosgui/ccicon.png"); imageView->setSize(CCSizeMake(200, 85)); imageView->setPosition(ccp(widgetSize.width / 2.0f, widgetSize.height / 2.0f + imageView->getSize().height / 4.0f)); m_pUiLayer->addWidget(imageView);
4.Label
4.1 标签类型
CocoLabel 是文本标签,通常用语表示一行文字。
CocoTextArea 是文本区,用于显示文本,于 CocoLabel 不同的是,label 只能 显示一行文 字,而 CocoTextArea 可以将文字显示在一个区域内,并可以换行。
CCLabelBMFont 是文字渲染标签类,相当于每次改变只改变了图片坐标,而CCLabelTTF要重新渲染.这个类使用之前,需要添加好字体文件,包括一个图片文件 (**.png) 和一个 字体坐标文件 (**.fnt)。
想更多了解下它们之间的区别及使用方法,可参考下: http://www.cnblogs.com/xuling/archive/2012/02/29/2372721.html
4.2 示例
//UILabel文字 m_pDisplayValueLabel = UILabel::create(); m_pDisplayValueLabel->setText("No Event"); m_pDisplayValueLabel->setFontName("Marker Felt"); m_pDisplayValueLabel->setAnchorPoint(ccp(0.5f, -1)); m_pDisplayValueLabel->setPosition(ccp(widgetSize.width / 2.0f, widgetSize.height / 1.5f)); m_pDisplayValueLabel->setColor(ccc3(159, 168, 176)); m_pUiLayer->addWidget(m_pDisplayValueLabel); //LabelAtlas示例 UILabelAtlas* labelAtlas = UILabelAtlas::create(); labelAtlas->setProperty("0987654321", "cocosgui/labelatlas.png", 17, 22, "0"); labelAtlas->setPosition(ccp((widgetSize.width) / 2, widgetSize.height / 2.0f)); m_pUiLayer->addWidget(labelAtlas); //labelBMFont示例 UILabelBMFont* labelBMFont = UILabelBMFont::create(); labelBMFont->setFntFile("cocosgui/bitmapFontTest2.fnt"); labelBMFont->setText("BMFont"); labelBMFont->setPosition(ccp(widgetSize.width / 2, widgetSize.height / 4.0f + labelBMFont->getSize().height / 8.0f)); m_pUiLayer->addWidget(labelBMFont);
5.滚动条
5.1 示例
5.2 代码:
//滑动条 UISlider* slider = UISlider::create(); slider->setTouchEnabled(true); slider->loadBarTexture("cocosgui/sliderTrack2.png"); slider->loadSlidBallTextures("cocosgui/sliderThumb.png", "cocosgui/sliderThumb.png", ""); slider->loadProgressBarTexture("cocosgui/slider_bar_active_9patch.png"); slider->setScale9Enabled(true); //是否支持九宫 slider->setCapInsets(CCRectMake(0, 0, 0, 0)); slider->setSize(CCSizeMake(250, 10)); slider->setPosition(ccp(widgetSize.width / 2.0f, widgetSize.height / 2.0f)); // slider->setPosition(ccp(widgetSize.width / 2.0f, widgetSize.height / 2.0f + slider->getSize().height * 2)); slider->addEventListenerSlider(this, sliderpercentchangedselector(HelloWorld::sliderEvent)); m_pUiLayer->addWidget(slider);处理事件
void HelloWorld::sliderEvent(CCObject *pSender, SliderEventType type) { switch (type) { case ::cocos2d::gui::SLIDER_PERCENTCHANGED: { UISlider* slider = dynamic_cast<UISlider*>(pSender); int percent = slider->getPercent(); m_pDisplayValueLabel->setText(CCString::createWithFormat("Percent %d", percent)->getCString()); } break; default: break; } }
接下来的,因例子的代码较长,在下一篇再做讲解吧~~~