类说明
分段按钮,segmentedControl由一个或多个segment组成,点击不同段得到不同的信息,每次只能选择一段。
基类
CAControl
CASegmentedControl 属性(点击查看方法介绍)
属性 | 说明 |
BackgroundView | 背景视图 |
CASegmentedControl 方法(点击查看方法介绍)
CASegmentedControl 属性说明
类型: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)
返回值: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
参数:
解释:获取Selected的index
返回值: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颜色