UISegmentedControl:insertSegmentWithImage() 方法
insertSegmentWithImage() 方法在指定的位置插入一个图片段。
语法
insertSegmentWithImage(image, { atIndex[, animated] })参数
image
这一段的图,UIImage 或 null。
options.atIndex
插在第几段前面,整数,必填。等于现有的段数时插在最后;比段数还大时也插在最后。小数向零取整。
options.animated 可选
布尔值。true:带动画地插入。不传时没有动画。
返回值
无(undefined)。
numberOfSegments 在方法返回时就已经加一,带动画时也不用等动画结束。插入位置后面各段的下标加一,selectedSegmentIndex 跟着变,仍然指着原来选中的那一段。
异常
TypeError
- 没有传
atIndex:insertSegmentWithImage needs { atIndex }。 atIndex是负数:atIndex must be a non-negative integer, got -1。atIndex转不出有限数(比如NaN):报错信息以atIndex must be a finite number开头。image不是UIImage也不是null:insertSegmentWithImage needs a UIImage or null。
抛了之后段数不变。
示例
js
const seg = new UISegmentedControl(['列表']);
const grid = UIImage.systemImageNamed('square.grid.2x2');
if (grid !== null) {
seg.insertSegmentWithImage(grid, { atIndex: 1 });
console.log(seg.imageForSegmentAtIndex(1) === grid);
}结果:输出 true。第 1 段显示宫格图标。图标的样子未在模拟器验证。
对应的 iOS API
-[UISegmentedControl insertSegmentWithImage:atIndex:animated:]。animated 在原生里是必传的参数,这里可以不传。