Skip to content

UISlider:setMaximumTrackImage() 方法 ​

setMaximumTrackImage() 方法给滑块的一个或几个状态设圆钮右边那一段轨道的图,替换系统画的样子。

语法 ​

setMaximumTrackImage(image, { forState })

参数 ​

image

UIImage,或者 null。null 去掉这几个状态的图。

options.forState

状态名的数组,必填。一般写 ['normal']:没有单独设过的状态使用 normal 的那张。状态名是 'normal'、'highlighted'(手指按着)、'disabled'、'selected'、'focused',见状态。

返回值 ​

无(undefined)。

异常 ​

TypeError

  • 没有传 forState:setMaximumTrackImage needs { forState }。
  • forState 里有不认识的状态名:forState has no value "pressed"; expected one of: normal / highlighted / disabled / selected / focused。
  • image 不是 UIImage 也不是 null:setMaximumTrackImage needs a UIImage or null。

示例 ​

js
const slider = new UISlider();
const dot = UIImage.systemImageNamed('circle.fill');
slider.setMaximumTrackImage(dot, { forState: ['normal'] });
console.log(slider.maximumTrackImageForState('normal') === dot);
console.log(slider.maximumTrackImageForState('highlighted') === dot);

效果

  • 输出两次 true:highlighted 没有单独设过,使用 normal 的那张。
  • 右段轨道显示成这张图。未在模拟器验证。

对应的 iOS API ​

-[UISlider setMaximumTrackImage:forState:]。状态在 ObjC 里是位掩码,这里写成数组。

参见 ​