CASegmentedControl（分段控制）

类说明

分段按钮，segmentedControl由一个或多个segment组成，点击不同段得到不同的信息，每次只能选择一段。

基类

CAControl

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

属性	说明
BackgroundView	背景视图

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

方法	说明
create	创建，并指定itemsCount，默认Frame为(0,0,0,0)
createWithFrame	创建，并指定其Frame和itemsCount，默认Frame为(0,0,0,0)
createWithCenter	创建，并指定其Create和itemsCount，默认Create为(0,0,0,0)
init	初始化
setBackgroundImage	设置背景图像
setTitleColor	设置标题颜色
getTitleColor	获取标题颜色
setImageColor	设置图像颜色
getImageColor	获取图像颜色
insertSegmentWithTitleAtIndex	根据传递的参数，插入segment并设置标题，标题默认为空。
insertSegmentWithImageAtIndex	根据传递的参数，插入segment并设置前景图片，标题默认为空。
removeSegmentAtIndex	移除segment的某一段
setTitleFontName	设置标题字体
setTitleFontSize	设置标题大小
setSegmentItemBackgroundImage	设置Segment背景图像
addTarget	添加点击事件
setSelectedAtIndex	设置Selected的index
getSelectedAtIndex	获取Selected的index
getNumberOfSegments	获取segment的数量
setTitleForSegmentAtIndex	设置segment标题，通过index
getTitleForSegmentAtIndex	获取segment标题，通过index
setImageForSegmentAtIndex	设置segment图像和状态，通过index
getImageForSegmentAtIndex	获取segment图像，通过index
setWidthForSegmentAtIndex	设置segment的宽度，通过index
getWidthForSegmentAtIndex	获取segment的宽度，通过index
setContentOffsetForSegmentAtIndex	设置segment偏移量，通过index
getContentOffsetForSegmentAtIndex	获取segment偏移量，通过index
setEnabledForSegmentAtIndex	设置segment的段是否启用，通过index
isEnabledForSegmentAtIndex	通过index 查看segment的段是否启用
setImageSizeAtIndex	设置图像大小和index
setImageSelectedColor	设置图像Selected颜色
getImageSelectedColor	获取图像Selected颜色
setTintColor	设置标题颜色
setTitleSelectedColor	设置标题Selected颜色
getTitleSelectedColor	获取标题Selected颜色

CASegmentedControl 属性说明

BackgroundView

类型：CAView*

解释：背景视图，get{}。

CASegmentedControl 方法说明

static CASegmentedControl* create(unsigned int itemsCount);

返回值：CASegmentedControl*

参数：

类型	参数名	说明
unsigned int	itemsCount	itemsCount

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

static CASegmentedControl* createWithFrame(const DRect& rect, unsigned int itemsCount);

返回值：CASegmentedControl*

参数：

类型	参数名	说明
DRect&	rect	区域大小
unsigned int	itemsCount	itemsCount

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

static CASegmentedControl* createWithCenter(const DRect& rect, unsigned int itemsCount);

返回值：CASegmentedControl*

参数：

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

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

virtual bool init();

返回值：bool

参数：

解释：初始化

void setBackgroundImage(CAImage* image);

返回值：void

参数：

类型	参数名	说明
CAImage*	image	图像

解释：设置背景图像

void setTitleColor(const CAColor4B& color);

返回值：void

参数：

类型	参数名	说明
CAColor4B&	color	标题颜色

解释：设置标题颜色

const CAColor4B& getTitleColor();

返回值：CAColor4B& 

参数：

解释：获取标题颜色

void setImageColor(const CAColor4B& color);

返回值：void

参数：

类型	参数名	说明
CAColor4B&	color	图像颜色

解释：设置图像颜色

const CAColor4B& getImageColor();

返回值：CAColor4B& 

参数：

解释：获取图像颜色

void insertSegmentWithTitleAtIndex(const std::string& title, int index);

返回值：void

参数：

类型	参数名	说明
std::string&	title	segment显示的标题
int	index	插入segment的位置

解释：根据传递的参数，插入segment并设置标题，标题默认为空。

void insertSegmentWithImageAtIndex(CAImage* image, int index, CAControlState controlState);

返回值：void

参数：

类型	参数名	说明
CAImage*	image	segment背景图片
int	index	segment的插入位置
CAControlState	controlState	segment的状态

解释：根据传递的参数，插入segment并设置前景图片，标题默认为空。

void removeSegmentAtIndex(int index);

返回值：void

参数：

类型	参数名	说明
int	index	segment的插入位置

解释：移除segment的某一段

void setTitleFontName(std::string titleName);

返回值：void

参数：

类型	参数名	说明
std::string	titleName	segment的标题字体

解释：设置标题字体

void setTitleFontSize(float titleSize);

返回值：void

参数：

类型	参数名	说明
float	titleSize	segment的标题大小

解释：设置标题大小

void setSegmentItemBackgroundImage(CAImage* image);

返回值：void

参数：

类型	参数名	说明
CAImage*	image	Segment的背景图像

解释：设置Segment背景图像

void addTarget(CAObject* target, SEL_CASegmentedControl selector);

返回值：void

参数：

类型	参数名	说明
CAObject*	target	当前对象
SEL_CASegmentedControl	selector	函数回调器

解释：添加点击事件

void setSelectedAtIndex(int index);

返回值：void

参数：

类型	参数名	说明
int	index	Selected的index

解释：设置Selected的index

int  getSelectedAtIndex();

返回值：int

参数：

解释：获取Selected的index

int  getNumberOfSegments();

返回值：int

参数：

解释：获取segment的数量

void setTitleForSegmentAtIndex(const std::string& title, int index);

返回值：void

参数：

类型	参数名	说明
std::string&	title	segment标题
int	index	插入segment的位置

解释：设置segment标题，通过index

std::string getTitleForSegmentAtIndex(int index);

返回值：std::string 

参数：

类型	参数名	说明
int	index	segment的位置

解释：获取segment标题，通过index

void setImageForSegmentAtIndex(CAImage* image, int index, CAControlState controlState);

返回值：void

参数：

类型	参数名	说明
CAImage*	image	segment图像
int	index	segment的位置
CAControlState	controlState	segment的状态

解释：设置segment图像和状态，通过index

CAImage* getImageForSegmentAtIndex(int index);

返回值：CAImage*

参数：

类型	参数名	说明
int	index	segment的位置

解释：获取segment图像，通过index

void setWidthForSegmentAtIndex(float width, int index);

返回值：void

参数：

类型	参数名	说明
float	width	segment的宽度
int	index	segment的位置

解释：设置segment的宽度，通过index

float getWidthForSegmentAtIndex(int index);

返回值：float

参数：

类型	参数名	说明
int	index	segment的位置

解释：获取segment的宽度，通过index

void setContentOffsetForSegmentAtIndex(DSize offset, int index);

返回值：void

参数：

类型	参数名	说明
DSize	offset	segment偏移量
int	index	segment的位置

解释：设置segment偏移量，通过index

DSize getContentOffsetForSegmentAtIndex(int index);

返回值：DSize

参数：

类型	参数名	说明
int	index	segment的位置

解释：获取segment偏移量，通过index

void setEnabledForSegmentAtIndex(bool isEnable, int index);

返回值：void

参数：

类型	参数名	说明
bool	isEnable	是否启用

解释：设置segment的段是否启用，通过index

bool isEnabledForSegmentAtIndex(int index);

返回值：bool

参数：

类型	参数名	说明
int	index	segment的位置

解释：通过index 查看segment的段是否启用

void setImageSizeAtIndex(DSize size, int index);

返回值：void

参数：

类型	参数名	说明
DSize	size	图像大小
int	index	segment的位置

解释：

设置图像大小和index

void setImageSelectedColor(const CAColor4B& color);

返回值：void

参数：

类型	参数名	说明
CAColor4B&	color	图像Selected颜色

解释：设置图像Selected颜色

const CAColor4B& getImageSelectedColor();

返回值：CAColor4B& 

参数：

解释：获取图像Selected颜色

void setTintColor(const CAColor4B& color);

返回值：void

参数：

类型	参数名	说明
CAColor4B&	color	标题颜色

解释：设置标题颜色

void setTitleSelectedColor(const CAColor4B& color);

返回值：void

参数：

类型	参数名	说明
CAColor4B&	color	标题Selected颜色

解释：设置标题Selected颜色

const CAColor4B& getTitleSelectedColor();

返回值：CAColor4B&

参数：

解释：获取标题Selected颜色