WKInterfaceSlider
Наследование
-
NSObject
-
WKInterfaceObject
-
WKInterfaceSlider
-
NSObject
-
WKInterfaceObject
-
WKInterfaceSlider
Оператор импорта
Swift
import WatchKit
Objective C
@import WatchKit;
Доступность
Доступный в iOS 8.2 и позже.
A WKInterfaceSlider
объект представляет визуальный контроль, используемый для выбора единственного значения с плавающей точкой из диапазона значений. Вы конфигурируете появление ползунков в Вашем файле раскадровки, включая изображения для отображения для минимального и максимального значения. Во время выполнения Вы используете объект ползунка включить ползунок или установить его значение.
Когда пользователь изменяет значение ползунка, WatchKit формирует новую ценность к методу действия ползунка. Формат метода действия ползунка следующие:
Swift
@IBAction func sliderAction(value: Float)
Objective C
- (IBAction)sliderAction:(float)value
Объявите, что метод этой формы в классе контроллера интерфейса раньше получал новое значение ползунка. Можно изменить имя метода на что-либо, что Вы любите. При конфигурировании ползунка в XCode подключите его селектор к методу пользовательского действия.
Не разделяйте на подклассы или создавайте экземпляры этого класса сами. Вместо этого определите выходы в своем классе контроллера интерфейса и подключите их к соответствующим объектам в Вашем файле раскадровки. Например, для обращения к объекту ползунка в интерфейсе определите свойство с помощью следующего синтаксиса в классе контроллера интерфейса:
Swift
@IBOutlet weak var mySlider: WKInterfaceSlider!
Objective C
@property (weak, nonatomic) IBOutlet WKInterfaceSlider* mySlider;
Во время инициализации Вашего контроллера интерфейса WatchKit создает новый экземпляр этого класса и присваивает его Вашему выходу. В той точке можно использовать объект в выходе для внесения изменений в экранный ползунок.
Соедините интерфейсом с параметрами конфигурации разработчика
XCode позволяет Вам сконфигурировать информацию о своем ползунке в Вашем файле раскадровки. Таблица 1 перечисляет атрибуты, которые можно сконфигурировать в раскадровке и их значении.
Атрибут |
Описание |
---|---|
Значение |
Начальное численное значение ползунка. Это значение должно быть между указанными минимальными и максимальными значениями. Щелчок по кнопкам ползунка уменьшает или увеличивает текущую стоимость, пока это не достигает минимального или максимального значения. |
Минимум |
Самое маленькое численное значение позволяется ползунком. |
Максимум |
Самое большое численное значение позволяется ползунком. |
Шаги |
Число шагов между минимальными и максимальными значениями. Ползунок использует число шагов для определения, сколько постепенно увеличить или постепенно уменьшить значение, когда пользователь взаимодействует со средствами управления ползунком. |
Непрерывный |
Стиль отображения для ползунка. Когда включено, значение ползунка выводит на экран свое значение с помощью существенной панели. Когда отключено, ползунок выводит на экран свое значение с помощью дискретных шагов. |
Цвет |
Цвет панели ползунка. Можно также выбрать цвет программно с помощью |
Минимальное изображение |
Имя изображения для отображения рядом с минимальным значением ползунка. Это изображение должно быть связано в приложении WatchKit. |
Макс. изображение |
Имя изображения для отображения рядом с максимальным значением ползунка. Это изображение должно быть связано Вашим приложением WatchKit. |
Включенный |
Флажок, указывающий, включен ли ползунок и отправляет ли это события, когда изменяется его значение. |
-
Изменяет значение ползунка.
Объявление
Swift
func setValue(_
value
: Float)Objective C
- (void)setValue:(float)
value
Параметры
value
Новое значение для ползунка. Если новое значение за пределами приемлемого диапазона ползунка, этот метод фиксирует новое значение к минимальному или максимальному значению.
Оператор импорта
Objective C
@import WatchKit;
Swift
import WatchKit
Доступность
Доступный в iOS 8.2 и позже.
-
Выбирает цвет панели ползунка.
Параметры
color
Пользовательский цвет, который будет применен к панели ползунка. Указание
nil
удаляет пользовательский цвет и возвращает ползунок цвету, указанному в файле раскадровки. Цвет панели ползунка по умолчанию является зеленым.Оператор импорта
Objective C
@import WatchKit;
Swift
import WatchKit
Доступность
Доступный в iOS 8.2 и позже.
-
Определяет номер шагов для ползунка.
Объявление
Swift
func setNumberOfSteps(_
numberOfSteps
: Int)Objective C
- (void)setNumberOfSteps:(NSInteger)
numberOfSteps
Параметры
numberOfSteps
Число шагов между минимальным и максимальным значением. Если значение ползунка непрерывно, вызывание этого метода не имеет никакого эффекта.
Обсуждение
Каждое касание на инкрементных или декрементных областях ползунка изменяет значение ползунка одним шагом. Значение каждого шага равно различию между минимальными и максимальными значениями, разделенными на число шагов. Например, если минимальное значение
0
, максимальное значение1
, и число шагов10
, каждый шаг постепенно увеличивает или постепенно уменьшает значение0.1
.Оператор импорта
Objective C
@import WatchKit;
Swift
import WatchKit
Доступность
Доступный в iOS 8.2 и позже.
-
Включает или отключает ползунок.
Объявление
Swift
func setEnabled(_
enabled
: Bool)Objective C
- (void)setEnabled:(BOOL)
enabled
Параметры
enabled
Булево значение, указывающее, включен ли ползунок или отключен.
Обсуждение
Отключенный ползунок не реагирует на касания во вверх и вниз по кнопкам. Когда пользователь касается включенного ползунка, WatchKit обновляет значение ползунка и выполняет связанный метод действия (если таковые имеются) в Вашем расширении WatchKit.
Оператор импорта
Objective C
@import WatchKit;
Swift
import WatchKit
Доступность
Доступный в iOS 8.2 и позже.