Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы WatchKit ссылка класса WKInterfaceSwitch

Опции
Развертывание Target:

На этой странице
Язык:

WKInterfaceSwitch

Наследование


Соответствует


Оператор импорта


Swift

import WatchKit

Objective C

@import WatchKit;

Доступность


Доступный в iOS 8.2 и позже.

A WKInterfaceSwitch объект представляет управление, переключающееся между На и От состояния. Переключатели обычно используются, чтобы указать, активирована ли опция или отключена. Вы устанавливаете начальное значение переключателя в Вашем файле раскадровки, но можете изменить то значение во время выполнения с помощью методов этого класса.

Когда пользователь изменяет значение переключателя, WatchKit формирует новую ценность к методу действия ползунка. Формат метода действия переключателя следующие:

Swift

  • @IBAction func switchAction(value: Bool)

Objective C

  • - (IBAction)switchAction:(BOOL)on

Объявите, что метод этой формы в классе контроллера интерфейса раньше управлял переключателем. Можно изменить имя метода на что-либо, что Вы любите. При конфигурировании переключателя в XCode подключите его селектор к методу пользовательского действия.

Не разделяйте на подклассы или создавайте экземпляры этого класса сами. Вместо этого определите выходы в своем классе контроллера интерфейса и подключите их к соответствующим объектам в Вашем файле раскадровки. Например, для обращения к объекту переключателя в интерфейсе определите свойство с помощью следующего синтаксиса в классе контроллера интерфейса:

Swift

  • @IBOutlet weak var mySwitch: WKInterfaceSwitch!

Objective C

  • @property (weak, nonatomic) IBOutlet WKInterfaceSwitch* mySwitch;

Во время инициализации Вашего контроллера интерфейса WatchKit создает новый экземпляр этого класса и присваивает его Вашему выходу. В той точке можно использовать объект в выходе для внесения изменений в экранный переключатель.

Соедините интерфейсом с параметрами конфигурации разработчика

XCode позволяет Вам сконфигурировать информацию о переключателях в Вашем файле раскадровки. Таблица 1 перечисляет атрибуты, которые можно сконфигурировать и их значение.

Атрибуты переключателя Table 1WatchKit

Атрибут

Описание

Состояние

Начальное состояние переключателя. Переключатель может быть выключен или включен. Можно изменить состояние переключателя программно во время выполнения с помощью setOn: метод.

Оттенок

Цвет переключателя, когда это находится в на состоянии.

Включенный

Флажок, указывающий, включен ли переключатель. Когда пользователь изменяет состояние переключателя, включенный переключатель вызывает свой метод действия. Можно включить или отключить переключатель программно с помощью setEnabled: метод.

Заголовок

Строка, которая будет выведена на экран рядом с переключателем. Если указано, строка заголовка выведена на экран рядом с переключателем.

Цвет

Цвет текста для строки заголовка переключателя. Можно также выбрать цвет переключателя использование setColor: метод.

Шрифт

Информация о шрифтах, которая будет применена к строке заголовка. Можно указать один из предопределенных стилей или предоставить информацию пользовательского стиля.

  • Устанавливает заголовок переключателя в указанную строку.

    Объявление

    Swift

    func setTitle(_ title: String?)

    Objective C

    - (void)setTitle:(NSString *)title

    Параметры

    title

    Текст, который будет выведен на экран в переключателе. Указание nil очищает текущий текст от переключателя.

    Обсуждение

    Этот метод ищет локализованную версию заголовка в Вашем расширении WatchKit Localizable.strings файл. Если это находит один, это использует локализованную строку для заголовка переключателя. Если это не находит локализованную версию строки, это использует значение в заголовке непосредственно. Текст заменяет предыдущий текстовый набор для переключателя.

    Заголовок переключателя составлен с помощью информации о шрифтах и информации о форматировании от раскадровки.

    Оператор импорта

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

    Доступный в iOS 8.2 и позже.

  • Устанавливает заголовок переключателя в указанную приписанную строку.

    Объявление

    Swift

    func setAttributedTitle(_ attributedTitle: NSAttributedString?)

    Objective C

    - (void)setAttributedTitle:(NSAttributedString *)attributedTitle

    Параметры

    attributedTitle

    Строка форматированного текста, которая будет выведена на экран в переключателе. Указание nil очищает текущий текст от переключателя.

    Обсуждение

    Этот метод устанавливает содержание переключателя к указанному тексту, заменяя предыдущий текст. Текст составлен с помощью информации о стилях в attributedTitle.

    При использовании разработанного текста в переключателях необходимо обеспечить локализованные версии текста сами. Приписанные строки могут не содержать никого NSTextAttachment объекты как часть их содержания.

    Оператор импорта

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

    Доступный в iOS 8.2 и позже.

  • Устанавливает состояние переключателя к указанному значению.

    Объявление

    Swift

    func setOn(_ on: Bool)

    Objective C

    - (void)setOn:(BOOL)on

    Параметры

    on

    Булево значение, указывающее, должен ли переключатель быть установлен в На или От состояния. Указать YEStrue установить переключатель в На состоянии.

    Обсуждение

    Используйте этот метод для установки значения переключателя. Если Вы хотите знать значение переключателя, используйте локальную переменную для отслеживания той информации.

    Оператор импорта

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

    Доступный в iOS 8.2 и позже.

  • Изменяет цвет оттенка переключателя, когда это идет.

    Объявление

    Swift

    func setColor(_ color: UIColor?)

    Objective C

    - (void)setColor:(UIColor *)color

    Параметры

    color

    Цвет оттенка для использования для переключателя. Указать nil использовать цвет переключателя по умолчанию.

    Оператор импорта

    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 и позже.