CCScrollView/CCTableView（CCTableViewDelegate CCTableViewDataSource CCTableView-滑动列表-游戏中大量使用 非常重要的一个类）

tableview

scrollViewDidScroll函数中有一段 ---- 即---滑动tableview时触发的函数 ： 会将全部显示的cell又一次刷新（刷新函数中调用了自己定义的tableCellAtIndex）

//////

for (unsigned int i=startIdx; i <= endIdx; i++)

{

//if ([m_pIndices containsIndex:i])

if (m_pIndices->find(i) != m_pIndices->end())

{

continue;

}

this->updateCellAtIndex(i);

}

////////

updateCellAtIndex(i);中有一段

////

cell = m_pDataSource->tableCellAtIndex(this, idx);

///

使用样例

//每一项的宽度和高度必须重写的一个虚函数

////////

///////

首先须要创建CCTableView。设置它的显示区域和显示方向，这里使用了纵向。设置每一个子项的宽度和高度，子项的数量以及每一个子项相应的内容。每一个子项是一个CCTableViewCell，这里进行了优化。复用了子项对象。

以下是效果图：



#ifndef __CCTABLEVIEW_H__

#define __CCTABLEVIEW_H__

#include "CCScrollView.h"

#include "CCTableViewCell.h"

#include <set>

#include <vector>

NS_CC_EXT_BEGIN

class CCTableView;

class CCArrayForObjectSorting;

typedef enum {

kCCTableViewFillTopDown, //靠顶端

kCCTableViewFillBottomUp

} CCTableViewVerticalFillOrder; //fill 装满 填充

/**

* Sole（唯一的） purpose（目的 用途） of this delegate（代表） is to single touch（单点触摸） event in this version.//这个版本号仅支持单点触摸

*/

class CCTableViewDelegate : public CCScrollViewDelegate

{

public:

/**

* Delegate to respond（做出反应） touch event

*/

virtual void tableCellTouched(CCTableView* table, CCTableViewCell* cell) = 0;

/**

* Delegate to respond a table cell press event.

*/

virtual void tableCellHighlight(CCTableView* table, CCTableViewCell* cell){};//Highlight
突出 加亮 点击事件

/**

* Delegate to respond a table cell release event

*/

virtual void tableCellUnhighlight(CCTableView* table, CCTableViewCell* cell){};//松开事件

/**

* Delegate called when the cell is about to（即将） be recycled. Immediately

* after this call the cell will be removed from the scene graph and

* recycled.

*/

virtual void tableCellWillRecycle(CCTableView* table, CCTableViewCell* cell){};//cell即将回收事件

};

/**

* Data source that governs（治理） table backend（后端） data.

*/

class CCTableViewDataSource

{

public:

virtual ~CCTableViewDataSource() {}

/**

* cell size for a given index

*

* @param idx the index of a cell to get a size

* @return size of a cell at given index

*/

virtual CCSize tableCellSizeForIndex(CCTableView *table, unsigned int idx) { //得到指定ins的cell的size

return cellSizeForTable(table);

};

/**

* cell height for a given table.

*/

virtual CCSize cellSizeForTable(CCTableView *table) { //cell的size

return CCSizeZero;

};

/**

* a cell instance at a given index

*

* @param idx index to search for a cell

* @return cell found at idx

*/

virtual CCTableViewCell* tableCellAtIndex(CCTableView *table, unsigned int idx) = 0; //得到指定idx的
cell

/**

* Returns number of cells in a given table view.

*/

virtual unsigned int numberOfCellsInTableView(CCTableView *table) = 0;//得到cell数量

};

/**

* UITableView counterpart（副本） for cocos2d for iphone.

* this is a very basic, minimal（最低的） implementation（实现） to bring UITableView-like
component into（作为组件插入） cocos2d world.

*/

class CCTableView : public CCScrollView, public CCScrollViewDelegate

{

public:

CCTableView();

virtual ~CCTableView();

/**

* An initialized（初始的） table view object

*/

static CCTableView* create(CCTableViewDataSource* dataSource, CCSize size);

/**

* An initialized table view object

*/

static CCTableView*create(CCTableViewDataSource* dataSource, CCSize size, CCNode
*container);

//////

CCTableView* CCTableView::create(CCTableViewDataSource* dataSource, CCSize size, CCNode *container)

{

CCTableView *table = new CCTableView();

table->initWithViewSize(size, container);

table->autorelease();

table->setDataSource(dataSource);

table->_updateCellPositions();

table->_updateContentSize();

return table;

}

///////

CCTableViewDataSource* getDataSource() { return m_pDataSource; }

void setDataSource(CCTableViewDataSource* source) { m_pDataSource = source; }

CCTableViewDelegate* getDelegate() { return m_pTableViewDelegate; }

void setDelegate(CCTableViewDelegate* pDelegate) { m_pTableViewDelegate = pDelegate; }

/**

* determines how cell is ordered and filled in the view. //确定cell在tableview中怎样排列

*/

void setVerticalFillOrder(CCTableViewVerticalFillOrder order);

CCTableViewVerticalFillOrder getVerticalFillOrder();

boolinitWithViewSize(CCSize size, CCNode* container = NULL);

////////

bool CCTableView::initWithViewSize(CCSize size, CCNode* container/* = NULL*/)

{

if (CCScrollView::initWithViewSize(size,container))

{

m_pCellsUsed = new CCArrayForObjectSorting();

m_pCellsFreed = new CCArrayForObjectSorting();

m_pIndices = new std::set<unsigned int>();

m_eVordering = kCCTableViewFillBottomUp;

this->setDirection(kCCScrollViewDirectionVertical);

CCScrollView::setDelegate(this);

return true;

}

return false;

}

////////

/**

* Updates the content of the cell at a given index.

*/

voidupdateCellAtIndex(unsigned int idx);//更新cell

////////////////

void CCTableView::updateCellAtIndex(unsigned int idx)

{

if (idx == CC_INVALID_INDEX)

{

return;

}

unsigned int uCountOfItems = m_pDataSource->numberOfCellsInTableView(this);

if (0 == uCountOfItems || idx > uCountOfItems-1)

{

return;

}

CCTableViewCell* cell = this->cellAtIndex(idx);

if (cell)

{

this->_moveCellOutOfSight(cell);

}

cell = m_pDataSource->tableCellAtIndex(this, idx);

this->_setIndexForCell(idx, cell);

this->_addCellIfNecessary(cell);

}

//////////////

void insertCellAtIndex(unsigned int idx);//插入新的cell

void removeCellAtIndex(unsigned int idx);//移除cell

void reloadData();//又一次下载datasource view 将更新

/**

* Dequeues a free cell if available. nil if not.

*/

CCTableViewCell *dequeueCell();//得到一个将要离队（释放）的cell

///////

CCTableViewCell *CCTableView::dequeueCell()

{

CCTableViewCell *cell;

if (m_pCellsFreed->count() == 0) {

cell = NULL; //假设释放池中没有就返回0

} else { //假设释放池中有就返回第一个

cell = (CCTableViewCell*)m_pCellsFreed->objectAtIndex(0);

cell->retain();

m_pCellsFreed->removeObjectAtIndex(0);

cell->autorelease();

}

return cell;

}

//////////

/**

* Returns an existing（眼下的） cell at a given index. Returns nil if a cell is nonexistent at the moment of query.

*/

CCTableViewCell *cellAtIndex(unsigned int idx);//按给定的idx
返回一个cell

////////

CCTableViewCell *CCTableView::cellAtIndex(unsigned int idx)

{

CCTableViewCell *found = NULL;

if (m_pIndices->find(idx) != m_pIndices->end())

{

found = (CCTableViewCell *)m_pCellsUsed->objectWithObjectID(idx);

}

return found;

}

///////////

virtual voidscrollViewDidScroll(CCScrollView* view);

//////////

void CCTableView::scrollViewDidScroll(CCScrollView* view)

{

unsigned int uCountOfItems = m_pDataSource->numberOfCellsInTableView(this);

if (0 == uCountOfItems)

{

return;

}

if(m_pTableViewDelegate != NULL) {

m_pTableViewDelegate->scrollViewDidScroll(this);

}

unsigned int startIdx = 0, endIdx = 0, idx = 0, maxIdx = 0;

CCPoint offset = ccpMult(this->getContentOffset(), -1);

maxIdx = MAX(uCountOfItems-1, 0);

if (m_eVordering == kCCTableViewFillTopDown)

{

offset.y = offset.y + m_tViewSize.height/this->getContainer()->getScaleY();

}

startIdx = this->_indexFromOffset(offset);

if (startIdx == CC_INVALID_INDEX)

{

startIdx = uCountOfItems - 1;

}

if (m_eVordering == kCCTableViewFillTopDown)

{

offset.y -= m_tViewSize.height/this->getContainer()->getScaleY();

}

else

{

offset.y += m_tViewSize.height/this->getContainer()->getScaleY();

}

offset.x += m_tViewSize.width/this->getContainer()->getScaleX();

endIdx = this->_indexFromOffset(offset);

if (endIdx == CC_INVALID_INDEX)

{

endIdx = uCountOfItems - 1;

}

#if 0 // For Testing.

CCObject* pObj;

int i = 0;

CCARRAY_FOREACH(m_pCellsUsed, pObj)

{

CCTableViewCell* pCell = (CCTableViewCell*)pObj;

CCLog("cells Used index %d, value = %d", i, pCell->getIdx());

i++;

}

CCLog("---------------------------------------");

i = 0;

CCARRAY_FOREACH(m_pCellsFreed, pObj)

{

CCTableViewCell* pCell = (CCTableViewCell*)pObj;

CCLog("cells freed index %d, value = %d", i, pCell->getIdx());

i++;

}

CCLog("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~");

#endif

if (m_pCellsUsed->count() > 0)

{

CCTableViewCell* cell = (CCTableViewCell*)m_pCellsUsed->objectAtIndex(0);

idx = cell->getIdx();

while(idx <startIdx)

{

this->_moveCellOutOfSight(cell);

if (m_pCellsUsed->count() > 0)

{

cell = (CCTableViewCell*)m_pCellsUsed->objectAtIndex(0);

idx = cell->getIdx();

}

else

{

break;

}

}

}

if (m_pCellsUsed->count() > 0)

{

CCTableViewCell *cell = (CCTableViewCell*)m_pCellsUsed->lastObject();

idx = cell->getIdx();

while(idx <= maxIdx && idx > endIdx)

{

this->_moveCellOutOfSight(cell);

if (m_pCellsUsed->count() > 0)

{

cell = (CCTableViewCell*)m_pCellsUsed->lastObject();

idx = cell->getIdx();

}

else

{

break;

}

}

}

for (unsigned int i=startIdx; i <= endIdx; i++)

{

//if ([m_pIndices containsIndex:i])

if (m_pIndices->find(i) != m_pIndices->end())

{

continue;

}

this->updateCellAtIndex(i);

}

}

//////////

virtual void scrollViewDidZoom(CCScrollView* view) {}

virtual bool ccTouchBegan(CCTouch *pTouch, CCEvent *pEvent);

virtual void ccTouchMoved(CCTouch *pTouch, CCEvent *pEvent);

virtual void ccTouchEnded(CCTouch *pTouch, CCEvent *pEvent);

virtual void ccTouchCancelled(CCTouch *pTouch, CCEvent *pEvent);

protected:

CCTableViewCell *m_pTouchedCell;//当前触摸的cell

CCTableViewVerticalFillOrder m_eVordering;//fill 模式

/**

* index set to query the indexes of the cells used.

*/

std::set<unsigned int>* m_pIndices;//保存cell idx的set

/**

* vector with all cell positions

*/

std::vector<float> m_vCellsPositions;//保存cell position的vector

//NSMutableIndexSet *indices_;

/**

* cells that are currently in the table

*/

CCArrayForObjectSorting* m_pCellsUsed;// table中当前全部cell

/**

* free list of cells

*/

CCArrayForObjectSorting* m_pCellsFreed;///

/**

* weak link to the data source object

*/

CCTableViewDataSource* m_pDataSource;////

/**

* weak link to the delegate object

*/

CCTableViewDelegate* m_pTableViewDelegate;////

CCScrollViewDirection m_eOldDirection;////

int __indexFromOffset(CCPoint offset);//依据偏移量得到idx

unsigned int _indexFromOffset(CCPoint offset);

CCPoint __offsetFromIndex(unsigned int index);//依据idx得到偏移量

CCPoint _offsetFromIndex(unsigned int index);

void _moveCellOutOfSight(CCTableViewCell *cell);////

void _setIndexForCell(unsigned int index, CCTableViewCell *cell);

void _addCellIfNecessary(CCTableViewCell * cell);///Necessary
必要的

void_updateCellPositions();//更新cell位置

///////

void CCTableView::_updateCellPositions() {

int cellsCount = m_pDataSource->numberOfCellsInTableView(this);

m_vCellsPositions.resize(cellsCount + 1, 0.0);

if (cellsCount > 0)

{

float currentPos = 0;

CCSize cellSize;

for (int i=0; i < cellsCount; i++)

{

m_vCellsPositions[i] = currentPos;

cellSize = m_pDataSource->tableCellSizeForIndex(this, i);

switch (this->getDirection())

{

case kCCScrollViewDirectionHorizontal:

currentPos += cellSize.width;

break;

default:

currentPos += cellSize.height;

break;

}

}

m_vCellsPositions[cellsCount] = currentPos;//1 extra value allows us to get right/bottom of the last cell

}

}

////////

public:

void_updateContentSize();//更新table尺寸

/////////

void CCTableView::_updateContentSize()

{

CCSize size = CCSizeZero;

unsigned int cellsCount = m_pDataSource->numberOfCellsInTableView(this);

if (cellsCount > 0)

{

float maxPosition = m_vCellsPositions[cellsCount];

switch (this->getDirection())

{

case kCCScrollViewDirectionHorizontal:

size = CCSizeMake(maxPosition, m_tViewSize.height);

break;

default:

size = CCSizeMake(m_tViewSize.width, maxPosition);

break;

}

}

this->setContentSize(size);

if (m_eOldDirection != m_eDirection)

{

if (m_eDirection == kCCScrollViewDirectionHorizontal)

{

this->setContentOffset(ccp(0,0));

}

else

{

this->setContentOffset(ccp(0,this->minContainerOffset().y));

}

m_eOldDirection = m_eDirection;

}

}

/////////

};

NS_CC_EXT_END

#endif /* __CCTABLEVIEW_H__ */