类说明
视图类CAView是整个CrossApp引擎最基本的类,负责将各式各样的界面呈现出来,我们在App中所能看见的的一切界面其实就是一个个CAView的组合。CAView负责在屏幕上定义矩形区域,在展示用户界面及响应用户界面交互方面发挥关键作用。每个视图对象要负责渲染试图矩形区域中的内容,并响应该区域内发生的操作事件,视图是应用程序用户交互的重要机制。
除了显示内容和处理事件之外,试图还可以管理一个或多个子视图。我们可以在一个view上面添加多个子view,而作为父view,即父节点,负责管理其直接子视图,并根据需要调整他们的位置和尺寸,以及响应他们没有处理的事件。
基类
CAResponder
CAView 方法(点击查看方法介绍)
CAView 方法说明
返回值:CAView*
参数:
解释:创建
static CAView* createWithFrame(const DRect& rect);
返回值:CAView*
参数:
类型 | 参数名 | 说明 |
DRect& | rect | 区域大小 |
解释:创建,并指定其Frame
static CAView* createWithFrame(const DRect& rect, const CAColor4B& color4B);
返回值:CAView*
参数:
类型 | 参数名 | 说明 |
DRect& | rect | 区域大小 |
CAColor4B& | color4B | view颜色 |
解释:创建,并指定Frame和Color
static CAView* createWithCenter(const DRect& rect);
返回值:CAView*
参数:
类型 | 参数名 | 说明 |
DRect& | rect | 中心点的位置及大小 |
解释:创建,并设置其Center
static CAView* createWithCenter(const DRect& rect, const CAColor4B& color4B);
返回值:CAView*
参数:
类型 | 参数名 | 说明 |
DRect& | rect | 中心点的位置及大小 |
CAColor4B& | color4B | view颜色 |
解释:创建,并设置其Center和Color
static CAView* createWithLayout(const DLayout& layout);
返回值:CAView*
参数:
类型 | 参数名 | 说明 |
const DLayout& | layout | layout |
解释:创建,并设置其Layout
static CAView* createWithLayout(const DLayout& layout, const CAColor4B& color4B);
返回值:CAView*
参数:
类型 | 参数名 | 说明 |
const DLayout& | layout | layout |
CAColor4B& | color4B | view颜色 |
解释:创建,并设置其Layout和Color
static CAView* createWithColor(const CAColor4B& color4B);
返回值:CAView*
参数:
类型 | 参数名 | 说明 |
CAColor4B& | color4B | view颜色 |
解释:创建,并指定Color
返回值:bool
参数:
解释:初始化
virtual bool initWithFrame(const DRect& rect);
返回值:bool
参数:
类型 | 参数名 | 说明 |
DRect& | rect | 区域大小 |
解释:初始化,并指定其Frame
virtual bool initWithCenter(const DRect& rect);
返回值:bool
参数:
类型 | 参数名 | 说明 |
DRect& | rect | 中心点大小 |
解释:初始化,并指定其Center
virtual bool initWithLayout(const DLayout& layout);
返回值:bool
参数:
类型 | 参数名 | 说明 |
const DLayout& | layout | layout |
解释:初始化,并指定其Layout
virtual bool initWithColor(const CAColor4B& color4B);
返回值:bool
参数:
类型 | 参数名 | 说明 |
CAColor4B& | color4B | view颜色 |
解释:初始化,并指定其Color
const char* description(void);
返回值:char*
参数:
解释:描述
virtual void setZOrder(int zOrder);
返回值:void
参数:
类型 | 参数名 | 说明 |
int | zOrder | zOrder轴值 |
解释:zOrder轴值
virtual void _setZOrder(int z);
返回值:void
参数:
类型 | 参数名 | 说明 |
int | z | z轴值 |
解释:z轴值
返回值:int
参数:
解释:获取z轴值
virtual void setVertexZ(float vertexZ);
返回值:void
参数:
类型 | 参数名 | 说明 |
float | vertexZ | 顶点z轴值 |
解释:顶点z轴值
返回值:float
参数:
解释:获取顶点z轴值
virtual void setScaleX(float fScaleX);
返回值:void
参数:
类型 | 参数名 | 说明 |
float | fScaleX | X轴缩放 |
解释:设置X轴缩放
返回值:float
参数:
解释:获取X轴缩放
virtual void setScaleY(float fScaleY);
返回值:void
参数:
类型 | 参数名 | 说明 |
float | fScaleY | Y轴缩放 |
解释:设置Y轴缩放
返回值:float
参数:
解释:获取Y轴缩放
virtual void setScale(float scale);
返回值:void
参数:
类型 | 参数名 | 说明 |
float | scale | 缩放 |
解释:设置缩放
返回值:float
参数:
解释:获取缩放
virtual void setScale(float fScaleX,float fScaleY);
返回值:void
参数:
类型 | 参数名 | 说明 |
float | fScaleX | 缩放X轴 |
float | fScaleY | 缩放Y轴 |
解释:设置缩放,并指定其X轴Y轴
virtual void setSkewX(float fSkewX);
返回值:void
参数:
类型 | 参数名 | 说明 |
float | fSkewX | X倾斜 |
解释:设置X倾斜
返回值:float
参数:
解释:获取X倾斜
virtual void setSkewY(float fSkewY);
返回值:void
参数:
类型 | 参数名 | 说明 |
float | fSkewY | Y倾斜 |
解释:设置Y倾斜
返回值:float
参数:
解释:获取Y倾斜
void setAnchorPoint(const DPoint& anchorPoint);
返回值:void
参数:
类型 | 参数名 | 说明 |
DPoint& | anchorPoint | 锚点 |
解释:设置锚点
const DPoint& getAnchorPoint();
返回值:DPoint&
参数:
解释:获取锚点
void setAnchorPointInPoints(const DPoint& anchorPointInPoints);
返回值:void
参数:
类型 | 参数名 | 说明 |
DPoint& | anchorPointInPoints | 锚点的点 |
解释:设置锚点的点
const DPoint& getAnchorPointInPoints();
返回值:DPoint&
参数:
解释:获取锚点的点
virtual void setFrame(const DRect& rect);
返回值:void
参数:
类型 | 参数名 | 说明 |
DRect& | rect | 区域大小 |
解释:设置Frame
virtual const DRect& getFrame() const;
返回值:DRect&
参数:
解释:获取Frame
virtual void setFrameOrigin(const DPoint& point);
返回值:void
参数:
类型 | 参数名 | 说明 |
DPoint& | point | 轴值 |
解释:设置Frame轴值
virtual const DPoint& getFrameOrigin();
返回值:DPoint&
参数:
解释:获取Frame轴值
virtual void setCenter(const DRect& rect);
返回值:void
参数:
类型 | 参数名 | 说明 |
DRect& | rect | 中心点大小 |
解释:设置Center
返回值:DRect
参数:
解释:获取Center
virtual void setBounds(const DRect& rect);
返回值:void
参数:
类型 | 参数名 | 说明 |
DRect& | rect | 边界大小 |
解释:设置边界
virtual DRect getBounds() const;
返回值:DRect
参数:
解释:获取边界
virtual void setCenterOrigin(const DPoint& point);
返回值:void
参数:
类型 | 参数名 | 说明 |
DPoint& | point | 轴值 |
解释:设置Center轴值
virtual DPoint getCenterOrigin();
返回值:DPoint
参数:
解释:获取Center轴值
virtual void setVisible(bool visible);
返回值:void
参数:
类型 | 参数名 | 说明 |
bool | visible | 是否可见 |
解释:设置是否可见
返回值:bool
参数:
解释:查看是否可见
virtual void setRotation(float fRotation);
返回值:void
参数:
类型 | 参数名 | 说明 |
float | fRotation | 旋转角度 |
解释:设置旋转,并指定角度
返回值:float
参数:
解释:获取旋转角度
virtual void setRotationX(float fRotaionX);
返回值:void
参数:
类型 | 参数名 | 说明 |
float | fRotaionX | X轴旋转角度 |
解释:设置X轴旋转,并指定角度
返回值:float
参数:
解释:获取X周旋转角度
virtual void setRotationY(float fRotationY);
返回值:void
参数:
类型 | 参数名 | 说明 |
float | fRotationY | Y轴旋转角度 |
解释:设置Y轴旋转,并指定角度
返回值:float
参数:
解释:获取Y轴旋转角度
virtual void addSubview(CAView * child);
返回值:void
参数:
类型 | 参数名 | 说明 |
CAView* | child | 子视图 |
解释:将子视图添加进当前视图
virtual void insertSubview(CAView* subview, int z);
返回值:void
参数:
类型 | 参数名 | 说明 |
CAView* | subview | 子视图 |
int | z | Z轴值 |
解释:将子视图添加进当前视图,并指定一个Z轴值
virtual CAView * getSubviewByTag(int tag);
返回值:CAView*
参数:
类型 | 参数名 | 说明 |
int | tag | 标签 |
解释:通过 tag 获取子视图
virtual CAView * getSubviewByTextTag(const std::string& textTag);
返回值:CAView*
参数:
类型 | 参数名 | 说明 |
std::string& | textTag | 文本标签 |
解释:通过 TextTag 获取子视图
virtual const CAVector<CAView*>& getSubviews();
返回值:CAVector<CAView*>&
参数:
解释:获取子视图的集合
virtual unsigned int getSubviewsCount(void) const;
返回值:unsigned int
参数:
解释:获取子视图数量
virtual void setSuperview(CAView* superview);
返回值:void
参数:
类型 | 参数名 | 说明 |
CAView* | superview | 视图 |
解释:设置视图
virtual CAView* getSuperview();
返回值:CAView*
参数:
解释:获取视图
virtual void removeFromSuperview();
返回值:void
参数:
解释:从父视图移除
virtual void removeSubview(CAView* subview);
返回值:void
参数:
类型 | 参数名 | 说明 |
CAView* | subview | 子视图 |
解释:删除子视图
virtual void removeSubviewByTag(int tag);
返回值:void
参数:
类型 | 参数名 | 说明 |
int | tag | 标签 |
解释:删除子视图,根据tag
virtual void removeSubviewByTextTag(const std::string& textTag);
返回值:void
参数:
类型 | 参数名 | 说明 |
std::string& | textTag | 文本标签 |
解释:删除子视图,根据TextTag
virtual void removeAllSubviews();
返回值:void
参数:
解释:移除当前视图的所有子视图
virtual void reorderSubview(CAView * child, int zOrder);
返回值:void
参数:
类型 | 参数名 | 说明 |
CAView* | child | 子视图 |
int | zOrder | z轴值 |
解释:记录子视图与对应的标签值
virtual void sortAllSubviews();
返回值:void
参数:
解释:对当前视图的所有子视图进行排序
返回值:bool
参数:
解释:查看是否运行
返回值:void
参数:
解释:进入
virtual void onEnterTransitionDidFinish();
返回值:void
参数:
解释:当图像加载时调用的事件回调
返回值:void
参数:
解释:退出
virtual void onExitTransitionDidStart();
返回值:void
参数:
解释:当图像加载结束时调用的事件回调
virtual CACamera* getCamera();
返回值:CACamera*
参数:
解释:获得相机
返回值:void
参数:
解释:显示
返回值:void
参数:
解释:访问
virtual CAResponder* nextResponder();
返回值:CAResponder*
参数:
解释:获取下一个Responder
返回值:CAView*
参数:
解释:复制View
virtual bool ccTouchBegan(CATouch *pTouch, CAEvent *pEvent);
返回值:bool
参数:
类型 | 参数名 | 说明 |
CATouch | *pTouch | 触摸传递对象 |
CAEvent | *pEvent | 此参数待定 |
解释:触摸事件开始时的回调函数
virtual void ccTouchMoved(CATouch *pTouch, CAEvent *pEvent);
返回值:void
参数:
类型 | 参数名 | 说明 |
CATouch | *pTouch | 触摸传递对象 |
CAEvent | *pEvent | 此参数待定 |
解释:触摸事件中触点移动时的回调函数
virtual void ccTouchEnded(CATouch *pTouch, CAEvent *pEvent);
返回值:void
参数:
类型 | 参数名 | 说明 |
CATouch | *pTouch | 触摸传递对象 |
CAEvent | *pEvent | 此参数待定 |
解释:触摸事件结束时的回调函数
virtual void ccTouchCancelled(CATouch *pTouch, CAEvent *pEvent);
返回值:void
参数:
类型 | 参数名 | 说明 |
CATouch | *pTouch | 触摸传递对象 |
CAEvent | *pEvent | 此参数待定 |
解释:触摸非正常结束时的回调函数(例如:电话或锁屏)