CAButton（按钮）

类说明

在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

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 setImageForState(const CAControlState& controlState, CAImage* var);

返回值：void

参数：

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

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

CAImage* getImageForState(const CAControlState& controlState);

返回值：CAImage*

参数：

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

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

void setTitleForState(const CAControlState& controlState, const std::string& var);

返回值：void

参数：

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

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

const std::string& getTitleForState(const CAControlState& controlState);

返回值：const std::string&

参数：

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

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

### void setImageColorForState(const CAControlState& controlState, const CAColor4B& var); 返回值：void

参数：

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

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

void setTitleColorForState(const CAControlState& controlState, const CAColor4B& var);

返回值：void

参数：

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

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

void setTitleFontName(const std::string& var);

返回值：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 interruptTouchState();

返回值：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

参数：

解释：删除所有回调事件