投稿
  1. Web176教程首页
  2. CrossApp 教程

CAAutoCollectionView（自动化布局容器）

terry • • CrossApp 教程 • 阅读 155

类说明：

CAAutoCollectionView同CATableView类似，主要用于数据的展示，实现了tableView的基本功能，同时对tableView拓展，更完美的进行展示数据。

CAAutoCollectionView的使用方法和CATableView比较类似，我们也要分别使用：CAAutoCollectionView、CACollectionViewCell、CAAutoCollectionViewDelegate、CAAutoCollectionViewDataSource来构建。

CAAutoCollectionView是表格视图的容器，是容器的载体。

CACollectionViewCell是表格视图的一个单元（本节后面简称cell）。

CAAutoCollectionViewDelegate是交互代理，响应cell选中和取消状态。

CAAutoCollectionViewDataSource是数据代理，设置Selection个数及Selection包含Item个数。

CAAutoCollectionView 属性（点击查看方法介绍）

属性说明
CollectionViewDataSource添加数据代理
CollectionViewDelegate添加交互代理
CollectionHeaderView添加头部视图
CollectionFooterView添加尾部视图
CollectionHeaderHeight设置头部的高度
CollectionFooterHeight设置尾部的高度
CollectionViewOrientationCollectionView方向取向
CollectionViewCellHoriAlignCollectionView的Cell水平对齐
CollectionViewCellVertAlignCollectionView的Cell垂直对齐
HoriCellIntervalcell水平间隔
VertCellIntervalcell垂直间隔
HoriMargins水平边距
VertMargins垂直边距
AllowsSelection允许选择
AllowsMultipleSelection允许多个选择
AlwaysTopSectionHeader总是顶部的标题
AlwaysBottomSectionFooter总是底部的节尾

CAAutoCollectionView 方法（点击查看方法介绍）

说明说明
createWithFrame创建，并指定其Frame
createWithCenter创建，并指定Color
init初始化
reloadData重载数据
dequeueReusableCellWithIdentifier从复用队列中寻找指定标识符的cell
setAllowsSelection是否开启cell选择
setAllowsMultipleSelection是否可以多选cell
setSelectRowAtIndexPath通过索引选择一行
setUnSelectRowAtIndexPath通过索引取消选择一行
setShowsScrollIndicators设置显示滚动指示器
cellForRowAtIndexPath根据索引获取显示的cell
displayingCollectionCell显示CollectionCell
getHighlightCollectionCell获取高亮显示的collectioncell
switchPCMode开关PC模式

我们本机的示例，不再使用自定义的CACollectionViewCell的方法来实现，我们来看看本节的示例代码：

FirstViewController.h内容：

#ifndef __HelloCpp__ViewController__
#define __HelloCpp__ViewController__
#include <iostream>
#include "CrossApp.h"
USING_NS_CC;
class FirstViewController : public CAViewController, CAAutoCollectionViewDataSource, CAAutoCollectionViewDelegate
{
     
protected:
    void viewDidLoad();
     
    void viewDidUnload();
     
public:
FirstViewController();
     
virtual ~FirstViewController();
     
    //选中
    virtual void collectionViewDidSelectCellAtIndexPath(CAAutoCollectionView *collectionView, unsigned int section, unsigned int item);
     
    //取消选中
    virtual void collectionViewDidDeselectCellAtIndexPath(CAAutoCollectionView *collectionView, unsigned int section, unsigned int item);
     
    //获取指定cell
    virtual CACollectionViewCell* collectionCellAtIndex(CAAutoCollectionView *collectionView, const DSize& cellSize, unsigned int section, unsigned int item);
     
    //项目大小
    virtual DSize collectionViewSizeForItemAtIndexPath(CAAutoCollectionView* collectionView, unsigned int section, unsigned int item);
     
    //每个Section中Item的个数
    virtual unsigned int numberOfItemsInSection(CAAutoCollectionView *collectionView, unsigned int section);
     
    //section的个数
    virtual unsigned int numberOfSections(CAAutoCollectionView *collectionView);
     
private:
    DSize size;
     
    CAAutoCollectionView* p_AutoCollection;
     
    std::vector<CAColor4B> colorArr;
         
};
 
 
#endif /* defined(__HelloCpp__ViewController__) */

FirstViewController.cpp内容：

#include "FirstViewController.h"
FirstViewController::FirstViewController()
{
}
FirstViewController::~FirstViewController()
{
}
void FirstViewController::viewDidLoad()
{
    //获得屏幕大小
    size = this->getView()->getBounds().size;
     
    //随机出颜色
    for (int i = 0; i < 40; i++)
    {
        char r = CCRANDOM_0_1() * 255;
        char g = CCRANDOM_0_1() * 255;
        char b = CCRANDOM_0_1() * 255;
         
        //将随机的ccc4对象放入到容器里
        colorArr.push_back(ccc4(r, g, b, 255));
    }
     
    //生成CACollectionView
    p_AutoCollection = CAAutoCollectionView::createWithFrame(this->getView()->getBounds());
    DRect rect = this->getView()->getBounds();
    CCLog("MaxX = %f", rect.getMaxX());
    CCLog("MaxX = %f", rect.getMaxY());
     
    //开启选中
    p_AutoCollection->setAllowsSelection(true);
     
    //开启多选
    p_AutoCollection->setAllowsMultipleSelection(true);
     
    //绑定交互代理
    p_AutoCollection->setCollectionViewDelegate(this);
     
    //绑定数据代理
    p_AutoCollection->setCollectionViewDataSource(this);
     
     
    //item水平间的距离
    p_AutoCollection->setHoriMargins(40);
    p_AutoCollection->setHoriCellInterval(40);
     
    //p_AutoCollection->setCollectionHeaderHeight(40);
     
    //itme竖直间的距离
    p_AutoCollection->setVertMargins(40);
    p_AutoCollection->setVertCellInterval(40);
     
    //p_AutoCollection->setCollectionFooterHeight(40);
     
    //添加到屏幕渲染
    this->getView()->addSubview(p_AutoCollection);
     
}
void FirstViewController::viewDidUnload()
{
    // Release any retained subviews of the main view.
    // e.g. self.myOutlet = nil;
}
//选中
void FirstViewController::collectionViewDidSelectCellAtIndexPath(CAAutoCollectionView *collectionView, unsigned int section, unsigned int item)
{
    //选中
    CCLog("选中");
}
//取消选中
void FirstViewController::collectionViewDidDeselectCellAtIndexPath(CAAutoCollectionView *collectionView, unsigned int section, unsigned int item)
{
    //取消选中
    CCLog("取消选中");
}
//获取指定cell
CACollectionViewCell* FirstViewController::collectionCellAtIndex(CAAutoCollectionView *collectionView, const DSize& cellSize, unsigned int section, unsigned int item)
{
    //根据标识获得CACollectionViewCell
    CACollectionViewCell* p_Cell = collectionView->dequeueReusableCellWithIdentifier("CrossApp");
    //如果没有找到相应的CACollectionViewCell则新建一个
    if (p_Cell == NULL)
    {
        p_Cell = CACollectionViewCell::create("CrossApp");
         
        //生成Item背景
        CAView* itemImage = CAView::createWithFrame(DRect(0, 0, cellSize.width, cellSize.height));
        itemImage->setTag(99);
        p_Cell->addSubview(itemImage);
        DSize itemSize = itemImage->getBounds().size;
         
        //生成itemCALabel
        CALabel* itemText = CALabel::createWithCenter(DRect(itemSize.width*0.5, itemSize.height*0.5, 150, 40));
        itemText->setTag(100);
        itemText->setFontSize(29);
        itemText->setTextAlignment(CATextAlignmentCenter);
        itemText->setVerticalTextAlignmet(CAVerticalTextAlignmentCenter);
        itemImage->addSubview(itemText);
    }
     
    //设置Item背景颜色
    CAView* itemImageView = p_Cell->getSubviewByTag(99);
    itemImageView->setColor(colorArr.at(item));
    CCLog("row = %d", item);
     
    //设置itme文本显示
    char pos[20] = "";
    sprintf(pos, "(%d,%d)", section, item);
    CALabel* itemText = (CALabel*)p_Cell->getSubviewByTag(99)->getSubviewByTag(100);
    itemText->setText(pos);
    return  p_Cell;
}
//项目大小
DSize FirstViewController::collectionViewSizeForItemAtIndexPath(CAAutoCollectionView* collectionView, unsigned int section, unsigned int item)
{
    DSize size;
    size.width = (this->getView()->getBounds().size.width - 40 * 4) / 3;
    size.height = (this->getView()->getBounds().size.width - 40 * 4) / 3;
    return size;
}
//每个Section中Item的个数
unsigned int FirstViewController::numberOfItemsInSection(CAAutoCollectionView *collectionView, unsigned int section)
{
    return 15;
}
//section的个数
unsigned int FirstViewController::numberOfSections(CAAutoCollectionView *collectionView)
{
    return 10;
}

CAAutoCollectionView 属性说明

CollectionViewDataSource

类型：CAAutoCollectionViewDataSource*

解释：添加数据代理，set/get{}。

CollectionViewDelegate

类型：CAAutoCollectionViewDelegate*

解释：添加交互代理，set/get{}。

CollectionHeaderView

类型：CAView*

解释：添加头部视图，set/get{}。

CollectionFooterView

类型：CAView*

解释：添加尾部视图，set/get{}。

CollectionHeaderHeight

类型：unsigned int

解释：设置头部的高度，set/get{}。

CollectionFooterHeight

类型：unsigned int

解释：设置尾部的高度，set/get{}。

CollectionViewOrientation

类型：CACollectionViewOrientation

解释：CollectionView方向取向，set/get{}。

CollectionViewCellHoriAlign

类型：CACollectionViewCellHoriAlign

解释：CollectionView的Cell水平对齐，set/get{}。

CollectionViewCellVertAlign

类型：CACollectionViewCellVertAlign

解释：CollectionView的Cell垂直对齐，set/get{}。

HoriCellInterval

类型：unsigned int

解释：cell水平间隔，set/get{}。

VertCellInterval

类型：unsigned int

解释：cell垂直间隔，set/get{}。

HoriMargins

类型：unsigned int

解释：水平边距，set/get{}。

VertMargins

类型：unsigned int

解释：垂直边距，set/get{}。

AllowsSelection

类型：bool

解释：允许选择，is{}。

AllowsMultipleSelection

类型：bool

解释：允许多个选择，is{}。

AlwaysTopSectionHeader

类型：bool

解释：总是顶部的标题，is/set{}。

AlwaysBottomSectionFooter

类型：bool

解释：总是底部的节尾，is/set{}。

CAAutoCollectionView 方法说明

static CAAutoCollectionView* createWithFrame(const DRect& rect);

返回值：CAAutoCollectionView* 

参数：

类型参数名说明
const DRect&rect区域大小

解释：创建，并指定其Frame

static CAAutoCollectionView* createWithCenter(const DRect& rect);

返回值：CAAutoCollectionView* 

参数：

类型参数名说明
const DRect& rect中心点的位置及大小

解释：创建，并指定Color

virtual bool init();

返回值：bool

参数：

解释：初始化

void reloadData();

返回值：void

参数：

解释：重载数据

CACollectionViewCell* dequeueReusableCellWithIdentifier(const char* reuseIdentifier);

返回值：CACollectionViewCell*

参数：

类型参数名说明
const char* reuseIdentifier重载标识符

解释：从复用队列中寻找指定标识符的cell

virtual void setAllowsSelection(bool var);

返回值：void

参数：

类型参数名说明
boolvar是否开启

解释：是否开启cell选择

virtual void setAllowsMultipleSelection(bool var);

返回值：void

参数：

类型参数名说明
boolvar是否开启

解释：是否可以多选cell

void setSelectRowAtIndexPath(unsigned int section, unsigned int item);

返回值：void

参数：

类型参数名说明
unsigned int sectionsection
unsigned intitem项目数量

解释：通过索引选择一行

void setUnSelectRowAtIndexPath(unsigned int section, unsigned int item);

返回值：void

参数：

类型参数名说明
unsigned int sectionsection
unsigned intitem项目数量

解释：通过索引取消选择一行

virtual void setShowsScrollIndicators(bool var);

返回值：void

参数：

类型参数名说明
boolvar是否开启

解释：设置显示滚动指示器

CACollectionViewCell* cellForRowAtIndexPath(unsigned int section, unsigned int row, unsigned int item);

返回值：CACollectionViewCell* 

参数：

类型参数名说明
unsigned int sectionsection
unsigned introw行
unsigned intitem项目数量

解释：根据索引获取显示的cell

const CAVector<CACollectionViewCell*>& displayingCollectionCell();

返回值：CAVector<CACollectionViewCell*>& 

参数：

解释：显示CollectionCell

CACollectionViewCell* getHighlightCollectionCell();

返回值：CACollectionViewCell*

参数：

解释：获取高亮显示的collectioncell

virtual void switchPCMode(bool var);

返回值：void

参数：

类型参数名说明
boolvar是否开启

解释：开关PC模式

作者：terry，如若转载，请注明出处：https://www.web176.com/crossapp/10187.html

赞 (0)
打赏 支付宝 支付宝 微信 微信
terryterry
0 0
上一篇 2023年2月21日
下一篇 2023年2月21日

相关推荐

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注