什么是CrossApp？

CrossApp是一款完全开源、免费、跨平台的移动应用开发引擎，基于最宽松的MIT开源协议，开发者根据自身情况使用CrossApp开发任何商业项目。CrossApp以C++作为开发语言，图形渲染基于OpenGL ES 2.0，采用MVC框架模式。使用CrossApp开发的应用程序支持导出到各大主流移动平台，真正实现"一次编码，多处运行"的跨平台开发技术。

CrossApp主要由9秒社团自研，官方制定了CrossApp的基本架构，确立了CrossApp的基本雏形，而其后的版本也将由来自各方的开发精英自愿组成的9秒社团常务贡献委员会共同进行更新和维护。

为什么选用CrossApp？

---

1. 跨平台性：CrossApp暂时主要支持目前最主流的移动平台IOS和Android，CrossApp的平台无关性，使得相对传统的iOS和Android原生应用开发，CrossApp更能节省开发的周期和成本，App开发完成后只需要经过较为简单的移植工作，就能轻松实现在不同平台上应用。
   
2. 丰富的UI控件：CrossApp的设计宗旨在于为移动应用开发者提供快速、高效的开发解决方案。在此基础上，CrossApp封装了大量的UI控件，各类控件的功能十分丰富，开发者可以直接使用这些控件进行应用的开发。这些控件基本满足应用开发需求中的大部分功能，也免去了自己封装UI控件花费的大量时间，进一步提升开发的效率、节省开发的成本。同时CrossApp也会整合部分由第三方开发者提供的优秀控件资源，更大的丰富CrossApp的UI控件。
   
3. 技术支持：官方会提供每天8小时的在线页面问答式服务，每个问题的反馈速度大概在30分钟左右，回复率90%。
   

CrossApp耗电优化

---

如何使用学学习CrossApp?

---

• 官方网址：http://crossapp.9miao.com/
  
• 官方论坛：http://www.9miao.com/forum-31-1.html
  
• Github Issues：https://github.com/9miao/CrossApp/issues
  
• 技术QQ群：63254880（3群）
  

版本下载：

---

在学习CrossApp之前必须要了解CrossApp的一些概要

1.CrossApp的功能？

---

CrossApp是一个开源、免费、跨平台的应用开发引擎，使用C++作为开发语言，目前主要支持导出iOS和Android平台的应用程序。有关CrossApp的详细介绍，请参阅CrossApp介绍。

下载地址：

        CrossApp工作Git ：http://git.oschina.net/9miao/CrossApp

        CrossApp GitHub ：https://github.com/9miao/CrossApp

2. CrossApp的基本框架

---

CrossApp是基于MVC模式设计的，关于CrossApp的MVC模式的详细说明,请参阅CrossApp的MVC模式

3.CrossApp要求的开发工具

---

在不进行移植导出应用程序安装包的情况下，开发不需要特殊的工具， IDE仅仅VS或Xcode就能满足开发、调试需求。在windows下CrossApp推荐使用Visual Studio 2012或更高版本作为开发的IDE,在Mac下推荐使用Xcode 5.0或更高版本作为开发的IDE。对于移植iOS，不需要特别的环境配置，如果需要移植Android，请分别参阅Windows和Mac下配置Android开发环境。

4. 创建CrossApp工程的方式

---

在Windows下，有两种创建CrossApp工程的方式：使用命令行方式和使用工程创建工具。在Mac下，使用命令行的方式创建。具体创建CrossApp工程的方式请参阅创建CrossApp跨平台工程。

CrossApp会为我们创建各个平台对应的工程入口，创建的工程默认放在引擎的projects目录下，在不同平台下分别运行不同的工程就能运行起来。例如，在Windows下我们可以直接运行proj.win32里的.sln文件直接在vs中运行工程，当需要移植到Android时需要在eclipse中导入proj.android。

大家学习CrossApp的时候，搞清楚基础概念性的东西，能够大大提高我们学习CrossApp的效率。今天就和大家简单谈谈CrossApp的坐标系统。

基础坐标系

---

CrossApp采用的坐标系是屏幕坐标系，即左上角为原点，向右为X轴增长方向、向下对应Y轴增长方向。如图：

节点的概念

---

除了显示内容和处理事件之外，试图还可以管理一个或多个子视图。我们可以在一个view上面添加多个子view，而作为父view，即父节点，负责管理其直接子视图，并根据需要调整他们的位置和尺寸，以及响应他们没有处理的事件。

根据类说明我们可以得出以下结论：

1. 所有能看到的都是CAView的派生类。
   
2. CAView上面可以添加子CAView。
   
3. 父节点管理子视图
   

新手朋友可能不看明白父节点和子视图的概念 并且B是添加在A上的，假如这时候，我们调整A的坐标位置，那么B也将随A的坐标改变而改变。这样我们就说：B是A的子节点（也称子视图），A是B的父节点。 由于B是A的子节点（子视图），那么B则可以使用A的节点坐标系        
，我画图来说明：

如图所示，屏幕上显示了两个CAView分别是A和B,

上下左右边距、中心点、宽高

---

CAView在坐标系中定义了属性：DLayout。API定义如下：

Layout

类型：DLayout
解释：确定view在屏幕上显示的自适应方式。

起始点、中心点、宽高（旧版本）

---

//Frame    CAView * frameView = CAView::createWithColor(CAColor_blue);    frameView->setFrame(DRect(100, 100, 100, 100));    //this->getView()->addSubview(frameView);         //添加并设置z为2    this->getView()->insertSubview(frameView, 2);         //Bounds    CAView* boundsView = CAView::createWithColor(CAColor_red);    boundsView->setBounds(DRect(300, 300, 100, 100));    this->getView()->addSubview(boundsView);         //Center    CAView* centerView = CAView::createWithColor(CAColor_orange);    centerView->setCenter(DRect(100, 100, 100, 100));    //this->getView()->addSubview(centerView);         //添加并设置z为1    this->getView()->insertSubview(centerView, 1);

测试View缩放后,frame和bounds的变化:

    //缩放后的Frame和Bounds    frameView->setScale(2);         DRect frameRect = frameView->getFrame();    DRect boundsRect = frameView-> getBounds();    CCLog( "frameView->getFrame():x:%f,y:%f,width:%f,height:%f", frameRect.getMinX(), frameRect.getMinY(), frameRect.getMaxX() - frameRect.getMinX(), frameRect.getMaxY() - frameRect.getMinY() );    CCLog( "frameView->getBounds():x:%f,y:%f,width:%f,height:%f", boundsRect.getMinX(), boundsRect.getMinY(), boundsRect.getMaxX() - boundsRect.getMinX(), boundsRect.getMaxY() - boundsRect.getMinY() );

我们在开发移动端应用时，首先会面临一个很棘手的问题，就是市场上的手机，平板等设备的屏幕尺寸、分辨率各有不同，屏宽比也多种多样，如何来解决这个问题呢？
想要解决这个问题，我们需要了解一下关于显示的一些基础概念，已经市场上我们常见的尺寸及分辨率。
常见的分辨率
1136*640，1920*1080，960*640，1280*720，800*480。
常见的屏幕尺寸
3.5英寸、4英寸、5英寸、5.5英寸、7英寸等等。

PX：pixels，就是绝对像素。大小固定，不会随着屏幕不同而改变

PPI：Pixels Per Inch所表示的是每英寸所拥有的像素（Pixel）数目。因此PPI数值越高，即代表显示屏能够以越高的密度显示图像。当然，显示的密度越高，拟真度就越高。

DPI：每英寸所包含的点，在Android设备上，通常以DPI来表示设备屏幕的显示精细度。通常情况下，PPI和DPI可以表示同一个概念，PPI主要针对显示设备，DPI更多应用于打印输出设备，但都表示每英寸所包含的像素点

CrossApp为我们提供的解决方案：

CrossApp提供的Dip类型数据

推荐适配方案

CrossApp 横屏竖屏切换方法

---

ios方法：

打开ios目录下RootViewController.mm文件

// Override to allow orientations other than the default portrait orientation.// This method is deprecated on ios6- (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation {    //竖屏    //return UIInterfaceOrientationIsPortrait( interfaceOrientation );    //横屏    //return UIInterfaceOrientationIsLandscape( interfaceOrientation );}// For ios6, use supportedInterfaceOrientations & shouldAutorotate instead- (NSUInteger) supportedInterfaceOrientations{     #ifdef __IPHONE_6_0    //竖屏    //return UIInterfaceOrientationMaskPortrait;    //横屏    //return UIInterfaceOrientationMaskLandscapeRight;#endif}- (UIInterfaceOrientation)preferredInterfaceOrientationForPresentation{    //竖屏    //return UIInterfaceOrientationPortrait;    //横屏    //return UIInterfaceOrientationLandscapeRight;

更改Device Orientation 属性为Landscape Right 如图：

Android 方法：

AndroidManifest.xml中 activity 找到 android:screenOrientation属性。

        "unspecified":默认值 由系统来判断显示方向.判定的策略是和设备相关的，所以不同的设备会有不同的显示方向. 

        "landscape":横屏显示（宽比高要长） 

        "portrait":竖屏显示(高比宽要长) 

        "user":用户当前首选的方向 

        "behind":和该Activity下面的那个Activity的方向一致(在Activity堆栈中的) 

        "sensor":有物理的感应器来决定。如果用户旋转设备这屏幕会横竖屏切换。 

        "nosensor":忽略物理感应器，这样就不会随着用户旋转设备而更改了（"unspecified"设置除外）。

MVC模式简介 

---

关于MVC模式，并没有一个非常明确的概念，在不同的开发环境中，设计可能有所区别。

面向对象的目标就是设计出低耦合、高聚合的程序，MVC模式提供了一种很好的解决方案。CrossApp是基于MVC模式的，这里的MVC即模型层(Model)、视图层(View)、控制层(Controller)，三者各司其职，共同维持一个完整的应用程序。

在CrossApp中的Model层也就是我们各种数据原型、业务逻辑和算法，View层顾名思义就是展现给用户的UI界面，而Controller层的职责就是把Model和View两个相互关联不大的层衔接起来。CrossApp通过CAView和丰富的UI控件来实现View层的功能，通过CAViewController及其子类来共同完成Controller层，实现Model和View之间的通信。

View层和Model层通常不能直接进行通信，View层接收用户的操作，并把操作通知给Controller，Controller接收到消息后就更新Model层。同理Model层的数据发生变动后，通知Controller，Controller提示View层进行界面的更新。

如何使用CrossApp开发应用程序

---

使用CrossApp开发移动应用程序必要的准备工作可参考以下步骤：

1. 从CrossApp官网http://crossapp.9miao.com/Home/List/index/cid/3.html下载CrossApp的源码，解压至本地计算机。以下是CrossApp解压的目录结构

2. 开发前的环境配置，在CrossApp的官网有环境配置的详细说明，参考说明进行开发前的环境配置，以便开发完成导出各个平台的安装包。

3. 以上两步完成后，现在就可以开始我们的App开发，首先需要新建一个自己的CrossApp工程，同样在环境配置文档中也说明了如何使用命令行新建一个CrossApp工程，运行proj.win32下的.sln文件就可以运行我们新建的工程， 

4. 参考CrossApp的API文档就可以进行我们跨平台应用程序的开发了，以后我们自己的编码通常就是从AppDelegate类开始，具体的使用范例可以参考CrossApp官网的Demo示例。

我创建一个名为HelloCrossApp的工程，那么在引擎的根目录的projects文件夹下，将会出现一个名为HelloCrossApp的工程目录。我们打开这个目录可见下图的的结构：

大家打开各自平台使用的工程配置，我以win下vs2013为例子截图

打开HelloCrossApp下的Classes目录，看到如下结构：

我在这里引用API给出的CAWindow和CAViewController解释

什么是CAWindow？

---

什么是CAViewController？

---

#ifndef  _APP_DELEGATE_H_#define  _APP_DELEGATE_H_ #include "CrossApp.h" /**@brief    The CrossApp Application.The reason for implement as private inheritance is to hide some interface call by CAApplication.*/ class  AppDelegate : private CrossApp::CCApplication{public:    AppDelegate();    virtual ~AppDelegate();         /**    @brief    Implement CAApplication and CCScene init code here.    @return true    Initialize success, app continue.    @return false   Initialize failed, app terminate.    */         /*    这个函数用于实现CAApplication和CAWindow（CCScene应该为注释的错误，以后版本会修正）的初始化    如果返回true，初始化成功，程序正常运行    如果返回false，初始化失败，程序终止运行    */         virtual bool applicationDidFinishLaunching();        /*    @brief  The function be called when the application enter background    @param  the pointer of the application    */         /*    当程序进入后台运行时，此函数会被调用（例如，电话）    */         virtual void applicationDidEnterBackground();         /*    @brief  The function be called when the application enter foreground    @param  the pointer of the application    */         /*    当程序从后台切回被激活时调用此函数    */         virtual void applicationWillEnterForeground();};#endif // _APP_DELEGATE_H_

我们再来看看Application.cpp里又都做了什么

#include "AppDelegate.h"#include "RootWindow.h" USING_NS_CC; AppDelegate::AppDelegate(){} AppDelegate::~AppDelegate() {     } bool AppDelegate::applicationDidFinishLaunching(){    // initialize director    //初始化direction    CAApplication* pDirector = CAApplication::getApplication();         //初始化窗口    CCEGLView* pEGLView = CCEGLView::sharedOpenGLView();    pDirector->setOpenGLView(pEGLView);         // run         //启动 RootWindow入口    pDirector->runWindow(RootWindow::create());    return true;} // This function will be called when the app is inactive. When comes a phone call,it's be invoked toovoid AppDelegate::applicationDidEnterBackground(){    //暂停动画    CAApplication::getApplication()->stopAnimation();         // if you use SimpleAudioEngine, it must be pause         //暂停音效，如果你有使用音效，希望程序切到后台音效停止，请解下面代码的注释        // SimpleAudioEngine::sharedEngine()->pauseBackgroundMusic();} // this function will be called when the app is active againvoid AppDelegate::applicationWillEnterForeground(){    //回复动画    CAApplication::getApplication()->startAnimation();         // if you use SimpleAudioEngine, it must resume here         //回复音效，如果你有使用音效，希望程序切到激活状态音效恢复，请解下面代码的注释        // SimpleAudioEngine::sharedEngine()->resumeBackgroundMusic();}

RootWindow比较简单，我这里就不想详述，我来看一看FirstViewController都做了什么？
首先打开FirstViewController.h文件

//加载函数 一般做初始化UI和逻辑void viewDidLoad();//卸载函数 一般做移除和释放void viewDidUnload();

再来看看FirstViewController.cpp的 vievDidLoad();里的代码：

void FirstViewController::viewDidLoad(){    // Do any additional setup after loading the view from its nib.    DRect winRect = this->getView()->getBounds(); //获得屏幕的Bounds（Bounds不收缩放影响）         //加载一张图片    CAImageView* imageView = CAImageView::createWithImage(CAImage::create("HelloWorld.png"));         //设置图片的Frame显示大小(Frame的值缩放后会被改变)    imageView->setFrame(winRect);         //将图片添加的到屏幕上面（如果不添加，那么这个ui将不会被渲染，内存也会在下一个loop时被释放）    this->getView()->addSubview(imageView);         //设置一个文本    CALabel* label = CALabel::createWithCenter(DRect(winRect.size.width*0.5, winRect.size.height*0.5-270, winRect.size.width, 200));         //文本水平方向中间对其    label->setTextAlignment(CATextAlignmentCenter);          //文本竖直方向中间对其    label->setVerticalTextAlignmet(CAVerticalTextAlignmentCenter);         //设置字体大小（CROSSAPP_ADPTATION_RATIO是用于适配的系数）    label->setFontSize(72 * CROSSAPP_ADPTATION_RATIO);         //设置文本内容    label->setText("Hello World!");         //设置文本颜色    label->setColor(CAColor_white);         //添加到屏幕并设置z轴    this->getView()->insertSubview(label, 1);}

CrossApp是用一种引用计数的方式来管理内存对象，通过CAObject、CAAutoreleasePool、CAPoolManager来完成内存的管理。

CAObject为引用计数类，在其构造函数的时候，CAObject的引用计数为1，但此时并未加入到自动释放池里，所有自动引用计数为0
在使用create创建对象时候，会调用autorelease，将对象放到对象池，CAAutoreleasePool的队列中接受管理。CAObject调用retain()则引用计数会增加1，调用release()引用计数会减少1.

CAAutoreleasePool是引擎初始化时创建了一个默认的自动释放对象列表，并把它加入到CAPoolManager里进行管理。

引擎每次主循环都会有一次CAPoolManager中pool的清理，那些引用计数为0的CAObject都会被释放掉。这就是CrossApp的内

存管理机制。

CAObject

//属性：//引用数量unsigned int m_uReference; //自动引用数量unsigned int m_uAutoReleaseCount;

//方法：//引用计数+1retain(); //引用计数-1relesase(); //添加到自动释放管理autorelease(); //返回当前的引用计数retainCount();

同时引擎为了方便内存管理，用一些关于内存管理的函数和宏定义。

还有专门用于适应CrossApp的数据容器:  CAVector、CAList、CADeque、CAMap 其使用方法类似于c++的vector、list、deque、map的用法，其根本不同在于其添加和移除时，遵循CrossApp的内存管理原则。


假如我们有需求，需要我们自己手动管理一个对象指针的内存，那么我们需要，retain()和relesase()在一个类中成对出现，遵循谁负责retain谁就负责relesase的原则。

CrossApp的根类是CAObject，主要分为视图(view)和控制器(controller)，view都派生自CAView，controller都派生自CAViewController。

CAView主要分为三类，用于显示文本和图片的view：CALabel、CAImageView、CAScale9ImageView；容器类：CAScrollView、CATableView、CACollectionView；控件类：CAButton、CAAlertView、CASlider、CASwitch、CASegmentedControl等。

CAControllerView包括三个子类：CADrawerController、CATabBarController和CANavigationController，分别实现不同的view管理方式。

下面是CrossApp的主要类结构图。

1.Windows下创建CrossApp工程

使用命令行的方式：在CrossApp的解压目录下CrossApp/tools/project-creator中有一个创建工程的Python脚本，我们使用create_project.py来创建工程。因此在Windows下要求安装Python环境，用于运行create_project.py脚本Python的安装过程很简单，需要注意的是，在安装完成后，需要在系统环境变量”Path”中加入Python的安装路径。

python下载地址：https://www.python.org/downloads/windows

命令行创建工程示例：

使用工具创建：在CrossApp的解压根目录，有一个project-creator.exe创建工程工具，我们可以直接运行这个工具，之后只需要输入工程名和包名就可以创建CrossApp工程。注意，无论使用哪种方式创建工程，包名的字段的首字母不能为数字，否则在Android下会产生错误。

2.Mac下创建CrossApp工程

在Mac下我们通过命令行的方式来创建CrossApp工程，由于Mac自带Python环境，所以直接通过命令行的方式创建工程，创建方式和在Windows下一样，运行create_project.py脚本创建工程。

命令行创建工程示例：

我们这里分别对CAVector、CAList、CADeque、CAMap的常用函数进行说明:

CAVector<CAObject*> ca_vector;//增ca_vector.insert(size_t index, CrossApp::CAObject *object);//插入一个元素到指定位置ca_vector.pushBack(CrossApp::CAObject *object);//在list末尾插入一个元素    //删ca_vector.erase(ca_vector.begin());//删除指定位置的元素ca_vector.erase(ca_vector.begin(),ca_vector.end());//删除指定范围的元素ca_vector.popBack();//删除最后一个元素ca_vector.clear();//删除所有元素     //查ca_vector.empty();//是否含有元素ca_vector.size();//返回vector中的元素个数ca_vector.end();//返回末尾的迭代器ca_vector.begin();//返回指向第一个元素的迭代器ca_vector.front();//返回第一个元素ca_vector.back();//返回最后一个元素  //遍历for (int i = 0; i < ca_vector.size(); i++) {    CAObject* obj = ca_vector.at(i);}

CAList<CAObject*> ca_list;//增ca_list.insert(size_t index, CrossApp::CAObject *object);//插入一个元素到指定位置ca_list.pushBack(CrossApp::CAObject *object);//在list末尾插入一个元素ca_list.pushFront(CrossApp::CAObject *object);//在list头部添加一个元素//删ca_list.erase(ca_list.begin());//删除指定位置的元素ca_list.erase(ca_list.begin(),ca_list.end());//删除指定范围的元素ca_list.popBack();//删除最后一个元素ca_list.popFront();//删除第一个元素ca_list.clear();//删除所有元素//查ca_list.size();//返回list中的元素个数ca_list.begin();//返回指向第一个元素的迭代器ca_list.end();//返回末尾的迭代器ca_list.front();//返回第一个元素ca_list.back();//返回最后一个元素//遍历std::list<CAObject*>::iterator it;for (it = ca_list.begin(); it != ca_list.end(); it++) {    CAObject* obj = (CAObject*)*it;}

CADeque<CAObject*> ca_deque;//增ca_deque.insert(size_t index, CrossApp::CAObject *object);//插入一个元素到指定位置ca_deque.pushBack(CrossApp::CAObject *object);//在list末尾插入一个元素ca_deque.pushFront(CrossApp::CAObject *object);//在list头部添加一个元素     //删ca_deque.erase(size_t index);//删除指定位置的元素ca_deque.erase(ca_deque.begin()+1, ca_deque.end()-2);//删除指定范围的元素ca_deque.popBack();//删除最后一个元素ca_deque.popFront();//删除第一个元素ca_deque.clear();//删除所有元素    //查ca_deque.size();//返回deque中的元素个数ca_deque.begin();//返回指向第一个元素的迭代器ca_deque.end();//返回末尾的迭代器ca_deque.front();//返回第一个元素ca_deque.back();//返回最后一个元素ca_deque.at(size_t index);//返指定位置的元素     //遍历for (int i = 0; i < ca_deque.size(); i++) {    CAObject* obj = ca_deque.at(i);}

CAMap<int, CAObject*> ca_map;//增ca_map.insert(int key, CrossApp::CAObject *object);//增加一个元素键值对     //删ca_map.erase(int key);//通过key删除元素ca_map.clear();//删除所有元素   //查ca_map.empty();//判断mpa是否是空ca_map.contains(int key);//是否有这个key返回boolca_map.getValue(int key);//根据key返回对应的Valuestd::vector<int> vec = ca_map.getKeys();//返回包含所有key的vector     //遍历std::map<int, CAObject*>::iterator it;for (it = ca_map.begin(); it != ca_map.end(); ++it) {    int key = it->first;    CAObject* obj = it->second;}

CAObject* obj = new CAObject();     CAVector<CAObject*> ca_vector;     //打印引用计数CCLog("count：%d",obj->retainCount());     //把obj添加到vector尾部ca_vector.pushBack(obj);     //打印引用计数CCLog("count：%d",obj->retainCount());     //把obj移除ca_vector.eraseObject(obj);     //打印引用计数CCLog("count：%d",obj->retainCount());

《一》工欲善其事，必先利其器。

---

环境需求如下:
        ①操作系统：windows7以上版本
        ②开发工具：vs2012以上版本（推荐vs2013）

            https://www.microsoft.com/zh-cn/download/details.aspx?id=44921

        ③Python: 推荐Python2.7版本(可装可不装,如果你要用命令行创建新工程项目就装吧)
        =========编译到android所用=========
        ④ADT(eclipse+androidSDK): adt-bundle-windows

            http://pan.baidu.com/s/1dDnvbjj

        ⑤androidNDK: 推荐android-ndk-r9c

            http://pan.baidu.com/s/1o6KmBmq

        ⑥JDK: jdk for windows就行了

            http://pan.baidu.com/s/1sj8BgNr

《二》创建一个新工程：

---

         

方法二: Python脚本创建
           1.双击安装Python
           2.配置环境path
            右键计算器（我的电脑）-->属性-->高级系统设置-->环境变量-->系统变量-->双击Path-->在变量值结尾添加：“;C:/Python27”（引号改成你的Python安装路径,注意前面有一个分号";"）

                

       看到提示成功的信息，工程就创建成功了！

《三》通过vs2013启动一个项目：

---

我们想要在win环境下搭建开发环境需要以下工具，请在必须下载完成后再开始学习：
首先下载CROSSAPP引擎:crossapp越新越好啦
                github地址：https://github.com/9miao/CrossApp
                oschina地址：http://git.oschina.net/9miao/CrossApp  （国内较快）
环境需求如下:
        ①操作系统：Mac OS
        ②开发工具：Xcode

           https://developer.apple.com/cn/xcode/downloads/

        ③Python: 推荐Python2.7版本(可装可不装,如果你要用命令行创建新工程项目就装吧)
        =========编译到android所用=========
        ④ADT(eclipse+androidSDK)

           http://pan.baidu.com/s/1dDnvbjj

        ⑤androidNDK: 推荐android-ndk-r9c

           http://pan.baidu.com/s/1o6KmBmq

        ⑥JDK 

           http://pan.baidu.com/s/1sj8BgNr

创建新项目：

---

                

               三、根据提示 输入创建c++代码项目命令：
                ./create_project.py -project MyGame -package com.MyCompany.AwesomeGame -language cpp
                看到下面的提示就创建成功了

                

方法二：project-creator.app创建项目
                双击CrossApp引擎根目录下的project-creator.app

这样我们点CrossApp引擎点根目录就会多一个名为projects的文件夹，这里面存放着我们创建的CrossApp项目。

运行新项目

---

                

类说明

DLayout自适应布局。

DLayout 属性（点击属性名可查看属性介绍）

DLayout 方法（点击属性名可查看属性介绍）

DHorizontalLayout 属性（点击属性名可查看属性介绍）

DVerticalLayout 属性（点击属性名可查看属性介绍）

使用介绍

---

//DLayout 相对于this->getView() 内缩50DPCAView * LayoutView = CAView::createWithColor(CAColor_blue);LayoutView->setLayout(DLayout(DHorizontalLayout_L_R(50, 50), DVerticalLayout_T_B(50, 50)));this->getView()->addSubview(LayoutView); //DLayout 塞满this->getView()CAView * LayoutView = CAView::createWithColor(CAColor_blue);LayoutView->setLayout(DLayoutFill);this->getView()->addSubview(LayoutView); //DLayout 宽高为300，在this->getView()中心CAView * LayoutView = CAView::createWithColor(CAColor_blue);LayoutView->setLayout(DLayout(DHorizontalLayout_W_C(300, 0.5), DVerticalLayout_H_C(300, 0.5)));this->getView()->addSubview(LayoutView);

CALayout 属性说明

horizontal

类型：DHorizontalLayout

解释：水平方向

vertical

类型：DVerticalLayout

解释：垂直方向

DHorizontalLayoutZero

类型：DHorizontalLayout

解释：水平方向L、R、W、C清零

DVerticalLayoutZero

类型：DVerticalLayout

解释：垂直方向T、B、H、C清零

DLayoutZero

类型：DLayoutZ

解释：Layout L、R、W、T、B、H、C清零

DHorizontalLayoutFill

类型：DHorizontalLayout

解释：水平方向塞满

DVerticalLayoutFill

类型：DVerticalLayout

解释：垂直方向塞满

DLayoutFill

类型：DLayout

解释：塞满

CALayout 方法说明

static inline DHorizontalLayout DHorizontalLayout_L_R(float left, float right);

返回值： DHorizontalLayout

参数：

解释：设置水平方向 左侧边距和右侧边距

static inline DHorizontalLayout DHorizontalLayout_L_W(float left, float width);

返回值： DHorizontalLayout

参数：

解释：设置水平方向 左侧边距和宽度

static inline DHorizontalLayout DHorizontalLayout_L_C(float left, float center);

返回值： DHorizontalLayout

参数：

解释：设置水平方向 左侧边距和中心点（中心点的float为当前屏幕的比例。如果想在屏幕水平方向的中间设置为0.5即可）

static inline DHorizontalLayout DHorizontalLayout_R_W(float right, float width);

返回值： DHorizontalLayout

参数：

解释：设置水平方向 右侧边距和宽度

static inline DHorizontalLayout DHorizontalLayout_R_C(float right, float center);

返回值： DHorizontalLayout

参数：

解释：设置水平方向 右侧边距和中心点（中心点的float为当前屏幕的比例。如果想在屏幕水平方向的中间设置为0.5即可）

static inline DHorizontalLayout DHorizontalLayout_W_C(float width, float center);

返回值： DHorizontalLayout

参数：

解释：设置水平方向 宽度和中心点（中心点的float为当前屏幕的比例。如果想在屏幕水平方向的中间设置为0.5即可）

static inline DVerticalLayout DVerticalLayout_T_B(float top, float bottom);

返回值： DVerticalLayout

参数：

解释：设置垂直方向 上边距和下边距

static inline DVerticalLayout DVerticalLayout_T_H(float top, float height);

返回值： DVerticalLayout

参数：

解释：设置垂直方向 上边距和宽度

static inline DVerticalLayout DVerticalLayout_T_C(float top, float center);

返回值： DVerticalLayout

参数：

解释：设置垂直方向 上边距和中心点（中心点的float为当前屏幕的比例。如果想在屏幕水平方向的中间设置为0.5即可）

static inline DVerticalLayout DVerticalLayout_B_H(float bottom, float height);

返回值： DVerticalLayout

参数：

解释：设置垂直方向 下边距和宽度

static inline DVerticalLayout DVerticalLayout_B_C(float bottom, float center);

返回值： DVerticalLayout

参数：

解释：设置垂直方向 下边距和中心点（中心点的float为当前屏幕的比例。如果想在屏幕水平方向的中间设置为0.5即可）

static inline DVerticalLayout DVerticalLayout_H_C(float height, float center);

返回值： DVerticalLayout

参数：

解释：设置垂直方向 高度和中心点（中心点的float为当前屏幕的比例。如果想在屏幕水平方向的中间设置为0.5即可）

DHorizontalLayout 属性说明

left

类型：float

解释：Layout 水平方向左侧边距（单位DP）

right

类型：float

解释：Layout 水平方向右侧边距（单位DP）

width

类型：float

解释：Layout 水平方向宽度（单位DP）

center

类型：float

解释：Layout 水平方向中心点（中心点的float为当前屏幕的比例。如果想在屏幕水平方向的中间设置为0.5即可）

DVerticalLayout 属性说明

top

类型：float

解释：Layout 垂直方向上边距（单位DP）

bottom

类型：float

解释：Layout 垂直方向下边距（单位DP）

height

类型：float

解释：Layout 垂直方向高度（单位DP）

center

类型：float

解释：Layout 垂直方向中心点（中心点的float为当前屏幕的比例。如果想在屏幕水平方向的中间设置为0.5即可）

类说明

标签文字类，用于显示文本。

CALabel 属性 （点击属性名可查看属性介绍）

CALabel 方法 （点击方法名可查看方法介绍）

使用介绍

    第一：Label的行数：
              其实Label行数是受Label的范围的影响，假如你设置的Frame太小，你超出Frame范围的行数是不被显示的。
        例如：Frame的范围只够显示2行，那么NumberOfLine设置比2大也是最多显示2行。

    第二：win开放中文字符：
              假如是是在win下开发CrossApp那么，label->setText("中文");这样直接设置中文字符，CALabel的显示不正常的。
        我们可以设置转为UTF8格式，格式如下：label->setText(UTF8("伟大的矮人王索林·橡木盾"));

    第三：LabelSize 版本6.0有个bug
              LabelSize在你缩放CALabel和改变CALabel的文本内容时候，LabelSize的值都不会变化。正常情况下应该是在文本            内容或字体大小发生改变时，LabelSize也跟着改变

//通过设置Center来创建一个CALabel （CRect前两个参数是中心点x,y；后两个参数是width，height）     CALabel* label = CALabel::createWithCenter(DRect(100, 200, 400, 400));    //设置文本水平方向的对齐方式    label->setTextAlignment(CATextAlignmentCenter);     //设置文本竖直方向的对齐方式    label->setVerticalTextAlignmet(CAVerticalTextAlignmentCenter);     //设置文本大小（CROSSAPP_ADPTATION_RATIO 是用于适配的缩放比）    label->setFontSize(72 * CROSSAPP_ADPTATION_RATIO);     //设置文本内容    label->setText("Hello World!");     //设置行数    label->setNumberOfLine(10);     //设置文本颜色    label->setColor(CAColor_white);    //设置文本字体    label->setFontName("fonts/arial.ttf");     this->getView()->insertSubview(label, 1);

CALabel 属性说明

Text

类型：string

解释：设置文本显示的字符串。 set/get{}。

 FontName

类型：string

解释：设置文本显示的字体。FontName

FontSize

类型：unsigned int

解释：设置文本小时的字体大小。set/get{}。

Dimensions

类型：DSize

解释：设置文本显示的尺寸大小。set/get{}。

VerticalTextAlignmet 

类型：CAVerticalTextAlignment

解释：设置文本显示的竖直对齐方式，枚举类型。set/get{}。

typedef enum    {    CAVerticalTextAlignmentTop,        //顶部对齐方式    CAVerticalTextAlignmentCenter,     //中心对齐方式    CAVerticalTextAlignmentBottom,     //底部对齐方式} CAVerticalTextAlignment;

TextAlignment 

类型：CATextAlignment

解释：设置文本显示的水平对齐方式，枚举类型。set/get{}。

typedef enum{    CATextAlignmentLeft,        //左对齐方式    CATextAlignmentCenter,      //中心对齐方式    CATextAlignmentRight,       //右对齐方式} CATextAlignment;

NumberOfLine

类型：unsigned int

解释：设置文本显示的行数。set/get{}。set/get{}。

UnderLine

类型：bool

解释：设置文本显示的字体下划线。set/get{}。

Bold

类型：bool

解释：设置文本显示的字体加粗。set/get{}。

Italics 

类型：bool

解释：设置文本显示的字体斜体。set/get{}。

EnableCopy

类型：bool

解释：设置文本显示的字体启用复制。set/get{}。

LineSpacing 

类型：int

解释：设置文本显示的字体行间距。set/get{}。

WordWrap

类型：bool

解释：设置文本显示的字体自动换行。set/get{}。

示例：

CALabel* c_Label = CALabel::createWithCenter(DRect(size.width*0.5,size.height*0.5,220,500));    c_Label->setText("CrossApp is a cross platform application engine,developed by 9miao.com");    c_Label->setTextAlignment(CATextAlignmentCenter);    c_Label->setColor(CAColor_orange);    c_Label->setFontSize(28);    this->getView()->addSubview(c_Label);

LabelSize

类型：DSize

解释：获取Label的大小。get{}。

CALabel 方法说明

void sizeToFit();

返回值： void

参数：

解释：设置自适应label宽度，即label的宽度随文本变化而变换。

void unsizeToFit();

返回值： void

参数：

解释：取消设置自适应label宽度

void applyStyle(const string& sStyleName);

返回值： void

参数：

解释：label的样式风格

void applyStyle(const CALabelStyle* pLabelStyle);

返回值： void

参数：

解释：label的应用风格

static CALabel* createWithFrame(const DRect& rect);

返回值： static CALabel*

参数：

解释：创建，并指定其Frame，默认Frame为(0,0,0,0)

static CALabel* createWithCenter(const DRect& rect);

返回值： static CALabel*

参数：

解释：创建，并指定其Frame，默认Center为(0,0,0,0)

virtual bool initWithFrame(const DRect& rect);

返回值： virtual bool

参数：

解释：初始化，并指定其Frame

virtual bool initWithCenter(const DRect& rect);

返回值：virtual bool

参数：

解释：初始化，并指定其Center

void setColor(const CAColor4B& var);

返回值： void

参数：

解释：设置label的颜色

const CAColor4B& getColor();

返回值： const CAColor4B&

参数：

解释：获取label的颜色

类说明

CAImage贴图类，即内存中的纹理，主要用于创建贴图对象，将图像加载进内存，是所有有关贴图类的基础。

CAImage 属性（点击方法名可查看方法介绍）

CAImage 方法（点击方法名可查看方法介绍）

CAImageView 属性（点击方法名可查看方法介绍）

CAImageView 方法（点击方法名可查看方法介绍）

使用方法

//创建一个CAImage    CAImage* image = CAImage::create("HelloWorld.png"); //CAImage函数//打印贴图描述    CCLog("Description:%s", image->description()); //打印像素格式    CCLog("StringForFormat:%s", image->stringForFormat());     //打印像素位深    CCLog("bitsPerPixelForFormat:%d", image->bitsPerPixelForFormat());     //方法一：通过CAImage创建一个CAImageView    CAImageView* imageView = CAImageView::createWithImage(image);     //设置显示的范围（如果不设置，默认不会被显示出来）    imageView->setFrame(winRect);     //添加到绘制     this->getView()->addSubview(imageView);      //方法二：通过设置Center创建一个CAImageViewD     CAImageView* imageView_1 = CAImageView::createWithCenter(DRect(50,50,100,100));      //设置显示的纹理     imageView_1->setImage(image);      //异步加载     //imageView_1->setImageAsyncWithFile("source_material/stepper_inc_n.png");      //添加到绘制，设置z轴为1     this->getView()->insertSubview(imageView_1,1);

        CCLog的打印结果：

    Description:<CAImage | Name = 3 | Dimensions = 640 x 960 | Coordinates = (1.00, 1.00)>
    StringForFormat:RGB888
    bitsPerPixelForFormat:32

CAImage 属性说明

PixelFormat

类型：CAImage::PixelFormat

解释：像素格式。get{}。

PixelsWide

类型：unsigned int

解释：像素宽。get{}。

PixelsHigh

类型：unsigned int

解释：像素高。get{}。

ContentSize

类型：DSize

解释：内容大小。get{}。

ShaderProgram

类型：CAGLProgram*

解释：着色程序。set/get{}。

Monochrome

类型：bool

解释：单色。is{}。

Data

类型：unsigned char*

解释：数据。get{}。

DataLenght

类型：unsigned long

解释：数据长度。get{}。

CAImage 方法说明

static CAImage* create(const std::string& file);

返回值：static CAImage*

参数：

解释：创建，默认Frame为(0,0,0,0)

static CAImage* createWithImageDataNoCache(const unsigned char * data, unsigned long lenght);

返回值：static CAImage*

参数：

解释：创建，默认没有缓存

static CAImage* createWithImageData(const unsigned char * data, unsigned long lenght, const std::string& key);

返回值：static CAImage*

参数：

解释：创建，默认有缓存

static CAImage* createWithString(const char *text, const char *fontName, float fontSize, const DSize& dimensions, CATextAlignment hAlignment, CAVerticalTextAlignment vAlignment, bool isForTextField = false, int iLineSpacing = 0, bool bBold = false, bool bItalics = false, bool bUnderLine = false);

返回值：static CAImage*

参数：

解释：创建，并指定文本内容

static int getFontHeight(const char* pFontName, unsigned long nSize);

返回值：static int

参数：

解释：获得字体高度

static int getStringWidth(const char* pFontName, unsigned long nSize, const std::string& pText); 

返回值：static int

参数：

解释：获得字体宽度

static int cutStringByWidth(const char* pFontName, unsigned long nSize, const std::string& text, int iLimitWidth, int& cutWidth);

返回值：static int

参数：

解释：减少字符串的宽度

static int getStringHeight(const char* pFontName, unsigned long nSize, const std::string& pText, int iLimitWidth, int iLineSpace = 0, bool bWordWrap = true);

返回值：static int 

参数：

解释：减少字符串的高度

static CAImage* scaleToNewImageWithImage(CAImage* image, const DSize& size);

返回值：static CAImage*

参数：

解释：缩放当前图像做新图像

static CAImage* scaleToNewImageWithImage(CAImage* image, float scaleX, float scaleY);

返回值：static CAImage*

参数：

解释：缩放当前图像做新图像

static CAImage* generateMipmapsWithImage(CAImage* image);

返回值：static CAImage*

参数：

解释：生成mipmap图像

static CAImage* createWithRawDataNoCache(const unsigned char * data, const CAImage::PixelFormat& pixelFormat, unsigned int pixelsWide, unsigned int pixelsHigh);

返回值：static CAImage* 

参数：

解释：创建，并指定Raw Data，默认没有缓存

static CAImage* createWithRawData(const unsigned char * data, const CAImage::PixelFormat& pixelFormat, nsigned int pixelsWide, unsigned int pixelsHigh, const std::string& key);

返回值：static CAImage*

参数：

解释：创建，并指定Raw Data，默认有缓存

bool initWithImageFile(const std::string& file);

返回值：bool

参数：

解释：初始化，并指定其图像文件

bool initWithImageFileThreadSafe(const std::string& fullPath);

返回值：bool

参数：

解释：初始化，并指定其图像文件（支持子线程）

bool initWithImageData(const unsigned char * data, unsigned long dataLen);

返回值：bool

参数：

解释：初始化，并指定其图像缓存

bool initWithRawData(const unsigned char * data, const CAImage::PixelFormat& pixelFormat, unsigned int pixelsWide, unsigned int pixelsHigh);

返回值：bool

参数：

解释：初始化，并指定其原数据

const char* description(void);

返回值：const char*

参数：

解释：获取图像描述

void releaseData();

返回值：void

参数：

解释：释放所有数据

void releaseData(unsigned char ** data);

返回值：void

参数：

解释：释放指定数据

void drawAtPoint(const DPoint& point);

返回值：void

参数：

解释：基于某个点显示（大小为图像大小）

void drawInRect(const DPoint& rect);

返回值：void

参数：

解释：基于某个矩形区域显示

bool initWithETCFile(const char* file);

返回值：bool

参数：

解释：初始化，并指定其ETC文件

const char* stringForFormat();

返回值：const char*

参数：

解释：格式字符串

bool saveToFile(const std::string& fullPath, bool bIsToRGB = false);

返回值：bool

 参数：

解释：是否保存成RGB格式

const char* getImageFileType();

返回值：const char*

参数：

解释：获取图像文件类型

float getAspectRatio();

返回值：float

参数：

解释：得到长宽比

CAImage::Format detectFormat(const unsigned char * data, unsigned long dataLen);

返回值： CAImage::Format

参数：

解释：检测格式

void premultipliedImageData();

返回值：void

参数：

解释：进行图像数据

void repremultipliedImageData();

返回值：void

参数：

解释：再进行图像数据

void updateGifImageWithIndex(unsigned int index);

返回值：void

参数：

解释：通过index更新GIF图像

unsigned int getGifImageIndex();

返回值：unsigned int

参数：

解释：获取GIF图像的index

unsigned int getGifImageCounts();

返回值：unsigned int

参数：

解释：获取GIF图像的参数

static void reloadAllImages();

返回值：static void

参数：

解释：重新加载所有图像

CAImageView 属性说明

ImageViewScaleType

类型：CAImageViewScaleType

解释：图像缩放类型。set/get{}。

AnimationImages

类型：CAVector<CAImage*>

解释：动画图像。set/get{}。

AnimationDuration

类型：float

解释：动画间隔的时间。set/get{}。

AnimationRepeatCount

类型：unsigned int

解释：动画重复次数。set/get{}。

CAImageView 方法说明

static CAImageView* create();

返回值：static CAImageView*

参数：

解释：创建，默认Frame为(0,0,0,0)

static CAImageView* createWithImage(CAImage* image);

返回值：static CAImageView*

参数：

解释：创建，并指定其Image

static CAImageView* createWithFrame(const DRect& rect);

返回值：static CAImageView*

参数：

解释：创建，并指定其Frame，默认Frame为(0,0,0,0)

static CAImageView* createWithCenter(const DRect& rect);

返回值：static CAImageView*

参数：

解释：创建，并指定其Center，默认Center为(0,0,0,0)

virtual bool init(void);

返回值：virtual bool

参数：

解释：初始化

virtual bool initWithImage(CAImage* image);

返回值：virtual bool

参数：

解释：初始化图像

virtual void setImage(CAImage* image);

返回值：virtual void

参数：

解释：设置图像

virtual CAImage* getImage(void);

返回值：virtual CAImage*

参数：

解释：获取图像

virtual void setImageAsyncWithFile(const std::string& path);

返回值：virtual void

参数：

解释：异步设置图像文件

void startAnimating();

返回值：void

参数：

解释：开始动画

void stopAnimating();

返回值：void

参数：

解释：结束动画

bool isAnimating();

返回值：bool

参数：

解释：查看图像动画

类说明

        CAScale9ImageView是CrossApp提供的一种九宫格拉伸图片的解决方案，我们先来了解一下什么是九宫格图片拉伸。
在App的设计过程中，为了适配不同的手机分辨率，图片大小需要拉伸或者压缩，这样就出现了可以任意调整大小的拉伸样式。

CAScale9ImageView 属性（点击方法名可查看方法介绍）

CAScale9ImageView 方法（点击方法名可查看方法介绍）

void FirstViewController::viewDidLoad()
{    //创建
    CAScale9ImageView* first9IV = CAScale9ImageView::createWithImage(
        CAImage::create("source_material/btn_rounded_normal.png"));    
    //设置显示大小（拉伸后的大小）
    //设置非拉伸区域为(5,5,20,20)    first9IV->setCapInsets(DRect(5,5,20,20));     
    this->getView()->addSubview(first9IV);
    first9IV->setFrame(DRect(100, 100, 50, 140));         //添加渲染         //创建
        CAImage::create("source_material/btn_rounded_highlighted.png"));
    CAScale9ImageView* second9IV = CAScale9ImageView::createWithImage(         //设置非拉伸区域与顶部的距离    second9IV->setInsetTop(3.0f);     
    second9IV->setInsetLeft(3.0f);
    //设置非拉伸区域与底部的距离    second9IV->setInsetBottom(3.0f);        //设置非拉伸区域与右边的距离    second9IV->setInsetRight(3.0f);         //设置非拉伸区域与左边的距离
    CALabel* image9Label = CALabel::createWithFrame(DRect(400, 200, 150, 40));
         //设置显示区域（拉伸后的大小）
    second9IV->setFrame(DRect(400, 200, 150, 40));
         //添加渲染    this->getView()->addSubview(second9IV);     
    this->getView()->addSubview(image9Label);
    //创建    image9Label->setText(UTF8("使用九图"));
    image9Label->setTextAlignment(CATextAlignmentCenter);
    image9Label->setVerticalTextAlignmet(CAVerticalTextAlignmentCenter);    
    imageView->setImage(CAImage::create("source_material/btn_rounded_highlighted.png"));
    //不使用9宫格拉伸 设置大小与上同    CAImageView* imageView = CAImageView::createWithFrame(DRect(400, 300, 150, 40));       //设置显示图片       //添加渲染    this->getView()->addSubview(imageView);       //创建
    imageLabel->setVerticalTextAlignmet(CAVerticalTextAlignmentCenter);
    CALabel* imageLabel = CALabel::createWithFrame(DRect(400, 300, 150, 40));    imageLabel->setText(UTF8("不用九图"));    imageLabel->setTextAlignment(CATextAlignmentCenter);    this->getView()->addSubview(imageLabel);
}

CAScale9ImageView 属性说明

OriginalSize

类型：DSize

解释：原始尺寸，get{}。

CapInsets

类型：DSize

解释：拉伸区域，get{}。

InsetLeft

类型：float

解释：左侧拉伸距离。get{}。

InsetTop

类型：float

解释：上侧拉伸距离。get{}。

InsetRight

类型：float

解释：右侧拉伸距离。get{}。

InsetBottom

类型：float

解释：下侧拉伸距离。get{}。

CAScale9ImageView 方法说明

static CAScale9ImageView* create();

返回值：static CAScale9ImageView*

参数：

解释：创建，默认Frame为(0,0,0,0)

static CAScale9ImageView* createWithImage(CAImage* image);

返回值：static CAScale9ImageView*

参数：

解释：创建，并指定其图像

static CAScale9ImageView* createWithFrame(const DRect& rect);

返回值：static CAScale9ImageView*

参数：

解释：创建，并指定其Frame，默认Frame为(0,0,0,0)

static CAScale9ImageView* createWithCenter(const DRect& rect);

返回值：static CAScale9ImageView*

参数：

解释：创建，并指定其Center，默认Center为(0,0,0,0)

virtual bool init();

返回值：virtual bool

参数：

解释：初始化

virtual bool initWithImage(CAImage* image);

返回值：virtual bool

参数：

解释：初始化，并指定其图像

virtual void setCapInsets(const DRect& capInsets);

返回值：virtual void

参数：

解释：设置拉伸区域

virtual void setInsetLeft(float insetLeft);

返回值：virtual void

参数：

解释：设置左侧拉伸区域

virtual void setInsetTop(float insetTop);

返回值：virtual void

参数：

解释：设置上侧拉伸区域

virtual void setInsetRight(float insetRight);

返回值：virtual void

参数：

解释：设置右侧拉伸区域

virtual void setInsetBottom(float insetBottom);

返回值：virtual void

参数：

解释：设置下侧拉伸区域

virtual void setColor(const CAColor4B& color);

返回值：virtual void

参数：

解释：设置颜色

virtual const CAColor4B& getColor();

返回值：virtual const CAColor4B&

参数：

解释：获取颜色

virtual void setAlpha(float alpha);

返回值：virtual void

参数：

解释：设置透明度

virtual CAView* copy();

返回值：virtual CAView*

参数：

解释：复制

virtual void setImage(CAImage* image);

返回值：virtual void

参数：

解释：设置图像

using CAView::getImage;

返回值：using

参数：

解释：获取图像

virtual void draw(void);

返回值：virtual void

参数：

解释：重新绘制图像

类说明

在app开放中按钮是最常用的控件之一，大家对Button的需要也多种多样，CrossApp提供了CAButton，其使用思路主要是根据状态设置来完成的。

CAButton按钮类，主要为了接收用户的点击操作，从而触发特定的事件。

CAButton 属性 （点击属性名可查看属性介绍）

CAButton 方法 （点击属性名可查看属性介绍）

/*    创建一个Button    参数类型CAButtonType:CAButtonTypeCustom、CAButtonTypeSquareRect、CAButtonTypeRoundedRect    CAButtonTypeCustom:默认看不见任何效果，需要自己定义效果    CAButtonTypeSquareRect:矩形边框类型    CAButtonTypeRoundedRect:圆角边框类型*/CAButton* firstButton = CAButton::create(CAButtonTypeRoundedRect); /*    设置Button的状态显示文本    CAControlStateNormal:缺省状态    CAControlStateHighlighted:高亮状态    CAControlStateDisabled:禁用状态    CAControlStateSelected:选中状态    CAControlStateAll:全部状态*/firstButton->setTitleForState(CAControlStateAll,"Button"); /*    设置Button的状态显示文本的颜色*/firstButton->setTitleColorForState(CAControlStateAll, ccc4(0, 0, 0, 255)); //设置Button文本的字体firstButton->setTitleFontName("宋体"); /*    设置Button的状态的背景View*///九宫格图//firstButton->setBackGroundViewForState(CAControlStateAll,CAScale9ImageView::createWithImage("HelloWorld.png"))； //设置纯色View//firstButton->setBackGroundViewForState(CAControlStateAll, CAView::createWithColor(CAColor_red)); /*    设置Button的状态的图片(不支持九宫格)*///firstButton->setImageForState(CAControlStateAll,CAImage::create("HelloWorld.png")); /*    设置Button的状态*///firstButton->setControlState(CAControlStateHighlighted); /*    设置Frame（如果不设置Frame，默认是不显示的）*/firstButton->setFrame(DRect(100,100,200,80)); //添加到绘制this->getView()->addSubview(firstButton); /*    设置Button的监听    CAControlEventTouchDown:按下按钮响应    CAControlEventTouchDownRepeat:(未实现预留)双击时响应    CAControlEventTouchMoved:触点在Button范围内移动    CAControlEventTouchMovedOutSide:触点移动到Button范围外    CAControlEventTouchUpInSide:触点在Button范围内抬起    CAControlEventTouchUpSide:Button抬起    CAControlEventTouchValueChanged:此状态在CAButton无效，在CASlider中响应*/firstButton->addTarget(this, CAControl_selector(FirstViewController::callbackDown), CAControlEventTouchDown); //此状态6.0版本未实现//firstButton->addTarget(this, CAControl_selector(FirstViewController::callbackDownRepeat), CAControlEventTouchDownRepeat); firstButton->addTarget(this, CAControl_selector(FirstViewController::callbackMoved), CAControlEventTouchMoved); firstButton->addTarget(this, CAControl_selector(FirstViewController::callbackMovedOutSide), CAControlEventTouchMovedOutSide); firstButton->addTarget(this, CAControl_selector(FirstViewController::callbackUpInSide), CAControlEventTouchUpInSide); firstButton->addTarget(this, CAControl_selector(FirstViewController::callbackUpSide), CAControlEventTouchUpSide); //此状态6.0版本 Button无效//firstButton->addTarget(this, CAControl_selector(FirstViewController::callbackValueChanged), CAControlEventTouchValueChanged); /*    中断监听*///firstButton->interruptTouchState();

监听的回调函数也很简单：有两个参数：CAControl* 和DPoint

CAControl是Button本身

DPoint是触点的坐标

void FirstViewController::callbackDown(CAControl* control, DPoint point){        CCLog("callbackDown()-->");} void FirstViewController::callbackDownRepeat(CAControl* control, DPoint point){        CCLog("callbackDownRepeat()-->");} void FirstViewController::callbackMoved(CAControl* control, DPoint point){        CCLog("callbackMoved()-->");} void FirstViewController::callbackMovedOutSide(CAControl* control, DPoint point){        CCLog("callbackMovedOutSide()-->");} void FirstViewController::callbackUpInSide(CAControl* control, DPoint point){        CCLog("callbackUpInSide()-->");        //((CAButton*)control)->setTitleForState(CAControlStateAll, "changed");} void FirstViewController::callbackUpSide(CAControl* control, DPoint point){        CCLog("callbackUpSide()-->");} void FirstViewController::callbackValueChanged(CAControl* control, DPoint point){        CCLog("callbackValueChanged()-->");}

CAButton 属性说明

AllowsSelected

类型：bool

解释：是否可以选择。is/set{}。

Selected

类型：bool

解释：是否被选择。is{}。

TouchClick

类型：bool

解释：是否被触摸点击。is{}。

CAButton 方法说明

static CAButton* create(const CAButtonType& buttonType);

返回值：static CAButton*

参数：

解释：创建

typedef enum{    CAButtonTypeCustom = 0,     默认看不见任何效果，需要自己定义效果    CAButtonTypeSquareRect,     矩形边框类型    CAButtonTypeRoundedRect,    圆角边框类型} CAButtonType;

static CAButton* createWithFrame(const DRect& rect, const CAButtonType& buttonType);

返回值：static CAButton*

参数：

解释：创建，并指定其Frame

typedef enum{    CAButtonTypeCustom = 0,     默认看不见任何效果，需要自己定义效果    CAButtonTypeSquareRect,     矩形边框类型    CAButtonTypeRoundedRect,    圆角边框类型} CAButtonType;

static CAButton* createWithCenter(const DRect& rect, const CAButtonType& buttonType);

返回值：static CAButton*

参数：

解释：创建，并指定其Center

typedef enum{    CAButtonTypeCustom = 0,     默认看不见任何效果，需要自己定义效果    CAButtonTypeSquareRect,     矩形边框类型    CAButtonTypeRoundedRect,    圆角边框类型} CAButtonType;

virtual bool init();

返回值：virtual bool

参数：

解释：初始化

void setBackGroundViewForState(const CAControlState& controlState, CAView *var);

返回值：void

参数：

解释：设置Button的状态的背景View

typedef enum{    CAControlStateNormal:       缺省状态    CAControlStateHighlighted:  高亮状态    CAControlStateDisabled:     禁用状态    CAControlStateSelected:     选中状态    CAControlStateAll:          全部状态}CAControlState;

CAView* getBackGroundViewForState(const CAControlState& controlState);

返回值：CAView*

参数：

解释：获取Button的状态的背景View

typedef enum{    CAControlStateNormal:       缺省状态    CAControlStateHighlighted:  高亮状态    CAControlStateDisabled:     禁用状态    CAControlStateSelected:     选中状态    CAControlStateAll:          全部状态}CAControlState;

返回值：void

参数：

解释：设置Button的状态和图像（不支持九宫格）

typedef enum{    CAControlStateNormal:       缺省状态    CAControlStateHighlighted:  高亮状态    CAControlStateDisabled:     禁用状态    CAControlStateSelected:     选中状态    CAControlStateAll:          全部状态}CAControlState;

返回值：CAImage*

参数：

解释：获取Button的状态和图像（不支持九宫格）

typedef enum{    CAControlStateNormal:       缺省状态    CAControlStateHighlighted:  高亮状态    CAControlStateDisabled:     禁用状态    CAControlStateSelected:     选中状态    CAControlStateAll:          全部状态}CAControlState;

返回值：void

参数：

解释：设置Button标题的显示文本

typedef enum{    CAControlStateNormal:       缺省状态    CAControlStateHighlighted:  高亮状态    CAControlStateDisabled:     禁用状态    CAControlStateSelected:     选中状态    CAControlStateAll:          全部状态}CAControlState;

返回值：const std::string&

参数：

解释：获取Button标题的显示文本

typedef enum{    CAControlStateNormal:       缺省状态    CAControlStateHighlighted:  高亮状态    CAControlStateDisabled:     禁用状态    CAControlStateSelected:     选中状态    CAControlStateAll:          全部状态}CAControlState;

返回值：void

参数：

解释：设置Button的图像颜色和状态

typedef enum{    CAControlStateNormal:       缺省状态    CAControlStateHighlighted:  高亮状态    CAControlStateDisabled:     禁用状态    CAControlStateSelected:     选中状态    CAControlStateAll:          全部状态}CAControlState;

返回值：void

参数：

解释：设置Button的标题颜色和状态

typedef enum{    CAControlStateNormal:       缺省状态    CAControlStateHighlighted:  高亮状态    CAControlStateDisabled:     禁用状态    CAControlStateSelected:     选中状态    CAControlStateAll:          全部状态}CAControlState;

返回值：void

参数：

解释：设置Button文本的字体

void setImageOffset(const DSize& offset);

返回值：void

参数：

解释：设置图像偏移

void setImageSize(const DSize& size);

返回值：void

参数：

解释：设置图像大小

void setTitleOffset(const DSize& offset);

返回值：void

参数：

解释：设置标题偏移量

void setTitleLabelSize(const DSize& size);

返回值：void

参数：

解释：设置标题标签大小

void setTitleFontSize(float fontSize);

返回值：void

参数：

解释：设置标题字体大小

virtual void setControlState(const CAControlState& var);

返回值：virtual void

参数：

解释：设置状态

typedef enum{    CAControlStateNormal:       缺省状态    CAControlStateHighlighted:  高亮状态    CAControlStateDisabled:     禁用状态    CAControlStateSelected:     选中状态    CAControlStateAll:          全部状态}CAControlState;

返回值：void

参数：

解释：中断接触状态

virtual bool ccTouchBegan(CATouch *pTouch, CAEvent *pEvent);

返回值：virtual bool

参数：

解释：触摸事件开始时的回调函数

virtual void ccTouchMoved(CATouch *pTouch, CAEvent *pEvent);

返回值：virtual void

参数：

解释：触摸事件中触点移动时的回调函数

virtual void ccTouchEnded(CATouch *pTouch, CAEvent *pEvent);

返回值：virtual void

参数：

解释：触摸事件结束时的回调函数

virtual void ccTouchCancelled(CATouch *pTouch, CAEvent *pEvent);

返回值：virtual void

参数：

解释：触摸非正常结束时的回调函数。（例如：电话或锁屏）

using CAControl::addTarget;

返回值：using

参数：

解释：添加回调事件

using CAControl::removeTarget;

返回值：using

参数：

解释：删除回调事件

using CAControl::removeAllTargets;

返回值：using

参数：

解释：删除所有回调事件

类说明

CATextView是多行输入框，其主要用法和CATextField相似。

CATextView 属性 （点击属性名可查看属性介绍）

CATextView 方法 （点击方法名可查看方法介绍）

CATextView 属性介绍            

TextFontSize

类型：int

解释：设置TextView的字体大小。set/get{}。

Text

类型：std::string

解释：设置TextView的文本内容。set/get{}。

TextColor

类型：CAColor4B

解释：设置TextView的文字颜色。set/get{}。

Delegate

类型：CATextViewDelegate*

解释：TextView绑定Delegate。set/get{}。

TextViewAlign

类型：TextViewAlign

解释：TextView的文本对齐方式。set/get{}。

ReturnType

类型：ReturnType

解释：TextView的确认键类型。set/get{}。

CATextView 方法介绍    

void setBackGroundImage(CAImage* image);

返回值：void

参数：

解释：设置输入框背景图片

virtual bool resignFirstResponder();

返回值：bool

参数：

解释：隐藏键盘第一响应者状态

virtual bool becomeFirstResponder();

返回值：bool

参数：

解释：弹出键盘第一响应者状态

static CATextView* createWithFrame(const DRect& rect);

返回值：CATextView*

参数：

解释：创建，并指定其Frame

static CATextView* createWithCenter(const DRect& rect);

返回值：CATextView*

参数：

解释：创建，并指定其Center

类说明

textView事件代理

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

CATextViewDelegate 方法说明

virtual bool textViewShouldBeginEditing(CATextView * sender)

返回值：bool

参数：

解释：开始编辑时触发

virtual bool textViewShouldEndEditing(CATextView * sender)

返回值：bool

参数：

解释：结束编辑时触发（如果发件人不想从时间中分离，返回true）

virtual void textViewShouldReturn(CATextView *sender){}

返回值：void

参数：

解释：返回时触发

virtual void keyBoardHeight(CATextView *sender, int height){}

返回值：void

参数：

解释：键盘高度

virtual bool textViewShouldChangeCharacters(CATextView* sender, unsigned int location, unsigned int lenght, const std::string& changedText);

返回值：bool

参数：

解释：TextView文字更改后触发（返回true表示修改生效，返回false表示不做修改，textField的内容不变）

类说明

CASwitch控件，它是开关控件，可以实现类型开关。

CASwitch 属性 （点击属性名可查看属性介绍）

CASwitch 方法 （点击方法名可查看方法介绍）

        
CASwitch使用起来也非常简单，我们看一下实例代码：
首先在.h文件添加CASwitch的监听函数

//CASwitch状态回调    void callback(CAControl* control, CCPoint point);

然后在cpp文件中添加一下代码：

void FirstViewController::viewDidLoad(){    // Do any additional setup after loading the view from its nib.    DSize size = this->getView()->getBounds().size;         //创建    CASwitch* defaultSwitch = CASwitch::createWithCenter(DRect(size.width*0.5, size.height*0.2, size.width*0.3, 20));         //设置tag    defaultSwitch->setTag(100);         //设置监听函数    defaultSwitch->addTarget(this, CAControl_selector(FirstViewController::callback));         //添加绘制    this->getView()->addSubview(defaultSwitch);         //创建    CASwitch* customSwitch = CASwitch::createWithCenter(DRect(size.width*0.5, size.height*0.4, size.width*0.3, 20));         //设置tag    customSwitch->setTag(101);         //设置开启时图片    customSwitch->setOnImage(CAImage::create("source_material/btn_rounded_highlighted.png"));         //设置关闭时图片    customSwitch->setOffImage(CAImage::create("source_material/btn_rounded_normal.png"));         //设置中间图片    customSwitch->setThumbTintImage(CAImage::create("source_material/btn_rounded3D_selected.png"));         //设置监听函数    customSwitch->addTarget(this, CAControl_selector(FirstViewController::callback));         //添加绘制    this->getView()->addSubview(customSwitch);}

监听函数内容如下：

void FirstViewController::callback(CAControl* control, DPoint point){    CCLog("callback");         //强转类型    CASwitch* caSwtich = (CASwitch*)control;         //获得tag    CCLog("Tag:%d", caSwtich->getTag());         //获得状态    if (!caSwtich->isOn())    {        CCLog("OFF");    }    else    {        CCLog("ON");    }}

CASwitch 属性介绍

On();

类型：bool

解释：查看是否处于开状态 。is{}。

TouchClick();

类型：bool

解释：查看是否处于触摸点击事件。is{}。

OnImage

类型：CAImage*

解释：获取开状态的图像。get{}。

OffImage

类型：CAImage*

解释：获取关状态的图像。get{}。

ThumbTintImage

类型：CAImage*

解释：获取Switch的图像。get{}。

CASwitch 方法介绍

void setOnImage(CAImage* onImage) 

返回值：void

参数：

解释：设置开状态时的图像

void setOffImage(CAImge* offImage)

返回值：void

参数：

解释：设置关状态时的图像

void setThumTintImage(CAImage* thumbTintImage)      

返回值：void

参数：

解释：设置Switch的背景图像

void setIsOn(bool on, bool animated);

返回值：void

参数：

解释：设置switch处于开状态

static CASwitch* createWithFrame(const DRect& rect);

返回值：static CASwitch*

参数：

解释：创建，并指定其Frame

static CASwitch* createWithCenter(const DRect& rect);

返回值：static CASwitch*

参数：

解释：创建，并指定其Center

void addTarget(CAObject* target, SEL_CAControl selector);

返回值：void

参数：

解释：添加回调事件

void removeTarget(CAObject* target, SEL_CAControl selector);

返回值：void

参数：

解释：删除回调事件

bool initWithFrame(const DRect& rect);

返回值：bool

参数：

解释：初始化，并指定其Frame

bool initWithCenter(const DRect& rect);

返回值：

参数：

解释：初始化，并指定其Center

类说明

CAProgress是进度条控件，主要用于显示任务进度。

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

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

CAProgress是一个很简单的控件，其使用方式也比较便捷，我们只需要在相应的逻辑里对齐值进行增减便可以了，下面我们的实例中，就演示了在CrossApp的定时器中，每间隔一段时间增减CAProgress的值，当CAProgress值超过最大时设置为0的循环演示。

首先我们在FirstViewController.h添加一个定时器函数

//定时器函数    void updateProgressValue(float dt);

然后在FirstViewController.cpp中添加一下代码：

void FirstViewController::viewDidLoad(){    // Do any additional setup after loading the view from its nib.    DSize size = this->getView()->getBounds().size;    CAProgress* progress = CAProgress::create();         //设置显示区域    progress->setCenter(DRect(size.width * 0.5,  200, 300, 60));         //设置进度值(0--1)之间的float    progress->setProgress(0.5f);         //设置进度的颜色    progress->setProgressTintColor(CAColor_orange);         //设置进度的图片    //progress->setProgressTintImage(CAImage::create("source_material/btn_rounded_highlighted.png"));         //设置背景的颜色    progress->setProgresstrackColor(CAColor_yellow);        //设置背景的图片    //progress->setProgressTrackImage(CAImage::create("source_material/btn_rounded3D_selected.png"));        //设置tag值    progress->setTag(1);        //添加到屏幕    this->getView()->addSubview(progress);         //创建Label用于显示progress的值    CALabel* label = CALabel::createWithCenter(DRect(size.width * 0.5, 100, 200, 100));        //水平剧中    label->setTextAlignment(CATextAlignmentCenter);        //显示progress的值    label->setText(crossapp_format_string("Progress:%.02f"));         //设置tag值    label->setTag(2);        //添加到屏幕    this->getView()->addSubview(label);         //启动定时器,间隔0.05秒调用    CAScheduler::schedule(schedule_selector(FirstViewController::updateProgressValue), this, 0.05, false);}     //定时器函数void FirstViewController::updateProgressValue(float dt){    //根据tag获得progress对象    CAProgress* progress = (CAProgress*) this->getView()->getSubviewByTag(1);        //获得progress的值    float value = progress->getProgress();         if (value < 1.0f)    {        value = value + 0.01;    }    else    {        value = 0;    }         //赋值    progress->setProgress(value);         //根据tag获得label    CALabel* label = (CALabel*)this->getView()->getSubviewByTag(2);         //显示value值    label->setText(crossapp_format_string("Progress:%.02f", value));}

CAProgress 属性说明

ProgressTintColor

类型：CAColor4B

解释：设置进度的颜色。set/get{}。

ProgressTrackColor

类型：CAColor4B

解释：设置背景的颜色。set/get{}。

ProgressTintImage

类型：CAImage*

解释：设置进度的图片。set/get{}。

ProgressTrackImage

类型：CAImage*

解释：设置背景的图片。set/get{}。

CAProgress 方法说明

bool init();

返回值：bool

参数：

解释：初始化