原文
在ios程序设计中,会大量使用到tableview视图(UITableView),那么在cocos2d-x中,如果需要类似的列表,该如何实现呢?在引擎中参照ios中的UITableView实现了一个叫做CCTableView的类,用于创建列表,对于熟悉ios程序设计的人来说,这个内容应该是很好理解的。
下面这篇博客就介绍一下是如何使用这个CCTableView的吧!
这个文件是在extensions这个文件夹中的:
下面通过一个demo详细介绍一下。
1、 使用的时候要注意要引入扩展库文件: #include "cocos-ext.h"
并且最好要添加: USING_NS_CC_EXT ; 这样就不用老是加前缀cocos2d::extension
#define USING_NS_CC_EXT using namespace cocos2d::extension
2、要继承CCTableView的两个代理 CCTableViewDelegate 和 CCTableViewDataSource
所以首先要继承这里两个代理:
class HelloWorld : public cocos2d::CCLayer,public cocos2d::extension::CCTableViewDelegate,public cocos2d::extension::CCTableViewDataSource
其中至少要实现以下的代理方法:
//触摸到某个cell的事件
virtual void tableCellTouched(cocos2d::extension::CCTableView* table, cocos2d::extension::CCTableViewCell* cell);
//定制每个cell的size
virtual cocos2d::CCSize tableCellSizeForIndex(cocos2d::extension::CCTableView *table, unsigned int idx);
//定制每个cell的内容
virtual cocos2d::extension::CCTableViewCell* tableCellAtIndex(cocos2d::extension::CCTableView *table, unsigned int idx);
//确定这个tableview的cell行数
virtual unsigned int numberOfCellsInTableView(cocos2d::extension::CCTableView *table);
可以选择实现:
//设置单元格高亮的状态 virtual void tableCellHighlight(CCTableView* table, CCTableViewCell* cell); //设置单元格非高亮的状态 virtual void tableCellUnhighlight(CCTableView* table, CCTableViewCell* cell);
3、有于CCTableView是继承 CCScrollView ,所以必须要继承这两个方法,但是什么都不做,只是空实现而已。
//由于CCTableView是继承CCScrollView,所以要继承这两个方法 virtual void scrollViewDidScroll(cocos2d::extension::CCScrollView* view) {} virtual void scrollViewDidZoom(cocos2d::extension::CCScrollView* view) {}
4、按照需要实现代理方法。
首先看看我定制的tableview吧!
其中每一个cell包含的内容:一个背景sprite(蓝色),左边一个label,中间一个menu。
(1)触摸到某个cell的事件处理:
void HelloWorld::tableCellTouched(cocos2d::extension::CCTableView *table, cocos2d::extension::CCTableViewCell *cell) { CCLOG("you touch cell index = %u",cell->getIdx()); }
(2)定制每一个cell的size
CCSize HelloWorld::tableCellSizeForIndex(cocos2d::extension::CCTableView *table, unsigned int idx) { return CCSizeMake(337, 55); }
(3)定制一个tableview的cell的个数
unsigned int HelloWorld::numberOfCellsInTableView(cocos2d::extension::CCTableView *table) { return 10; }
(4)定制每一个cell的内容
CCTableViewCell* HelloWorld::tableCellAtIndex(cocos2d::extension::CCTableView *table, unsigned int idx) { CCString *string = CCString::createWithFormat("index = %d",idx); CCTableViewCell *cell = table->dequeueCell(); if (!cell) { cell = new CustomTableCell(); cell->autorelease(); //添加背景图片 CCSprite *sprite = CCSprite::create("22.png"); sprite->setAnchorPoint(CCPointZero); sprite->setPosition(ccp(0, 0)); cell->addChild(sprite,1); //添加label CCLabelTTF *label = CCLabelTTF::create(string->getCString(), "Arial", 15); label->setAnchorPoint(CCPointZero); label->setTag(123); label->cocos2d::CCNode::setPosition(5, 5); cell->addChild(label,2); //添加menu CCMenuItemImage *itemImage = CCMenuItemImage::create("23.png", "24.png", cell, menu_selector(HelloWorld::menuCallBack)); CCMenu *menu = CCMenu::create(itemImage,NULL); //注意CCMenu是无法修改锚点的,其默认位置是在其几何中心 menu->setPosition(ccp(180,26)); //可以通过修改CCMenuItemImage的锚点的位置 // itemImage->setAnchorPoint(CCPointZero); // menu->setPosition(ccp(180,6)); cell->addChild(menu, 2); } else { //由于每一个cell的label都是不同的,所以我们通过tag值获取到label来对label进行修改 CCLabelTTF *label = (CCLabelTTF*)cell->getChildByTag(123); label->setString(string->getCString()); } return cell; } void HelloWorld::menuCallBack(cocos2d::CCObject *pSender) { CCTableViewCell *cell = (CCTableViewCell*)(((CCMenuItemImage*)pSender)->getParent()->getParent()); CCLog("menu click cell index : %d",cell->getIdx()); }
这一部分是最重要的部分,稍微解说一下吧!
①这里tableview也是用到了ios中cell的重用机制: CCTableViewCell *cell = table->dequeueCell (); 当然这也导致了下面的一些问题:每一个cell 的 label 中的内容都是不一样的,所以要对label进行一些处理。
②添加menu,我们可能要在menu点击的时候获取所在cell的一些消息,这里也要注意是如何处理的:是通过两次getParent获取到cell。
③还有在添加menu的时候意外发现一个问题:CCMenu是无法修改锚点值的,其锚点值是在其几何位置的中心 。但是我们可以修改其子项的锚点值。
④由于Menu的触摸响应优先级是最高的,所以点击menu的时候是不会触发 cell 的 touch 事件的。
⑤在向cell添加内容的时候要注意zOrder,否则有可能被其他元素覆盖了。
⑥其中的tableview cell是可以定制的,代码中用到的 CustomTableCell 内容如下:
#ifndef __TableView__CustonTabelCell__
#define __TableView__CustonTabelCell__
#include <iostream>
#include "cocos-ext.h"
#include "cocos2d.h"
USING_NS_CC;
USING_NS_CC_EXT;
class CustomTableCell:public cocos2d::extension::CCTableViewCell
{
public:
void draw();
};
#endif /* defined(__TableView__CustonTabelCell__) */
#include "CustonTabelCell.h"
void CustomTableCell::draw()
{
CCTableViewCell::draw();
}
其中是没有添加定制实现的。
5、设置cell被点击时高亮和非高亮。
void HelloWorld::tableCellHighlight(cocos2d::extension::CCTableView *table, cocos2d::extension::CCTableViewCell *cell) { CCLog("High light"); CCSprite *sprite1 = CCSprite::create("21.png"); sprite1->setTag(21); sprite1->setOpacity(125); //设置透明度 sprite1->setAnchorPoint(CCPointZero); sprite1->setPosition(ccp(0, 0)); cell->addChild(sprite1,3); } void HelloWorld::tableCellUnhighlight(cocos2d::extension::CCTableView *table, cocos2d::extension::CCTableViewCell *cell) { CCLog("Unhigh light"); cell->removeChildByTag(21); }
好啦,大概tableview常用的一些操作就是这些了,当然CCTabelView中还有一些其他方法,这些都是和ios中的差不多的,需要的时候查看就可以了。