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

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

Разработчик

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

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

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

WKInterfaceController

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

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

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

Swift

import WatchKit

Objective C

@import WatchKit;

Доступность

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

WKInterfaceController класс является основным классом для реализации Вашего интерфейса приложения WatchKit. Контроллер интерфейса служит той же цели как a UIViewController объект в UIKit, за исключением того, что это не управляет никакими фактическими представлениями. Это работает в Вашем расширении WatchKit и удаленно управляет поведением Вашей работы интерфейса Часов Apple. Вы используете контроллеры интерфейса для конфигурирования элементов каждой сцены, включая метки, изображения и средства управления, и Вы используете их для ответа на взаимодействия с теми элементами.

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

Инициализация Ваших контроллеров интерфейса

Когда пользователь запускает Ваше приложение WatchKit, системные нагрузки корневой интерфейс и запускает Ваше расширение WatchKit на iPhone пользователя. В Вашем расширении WatchKit инстанцирует и инициализирует класс, связанный с корневым контроллером интерфейса. Это тогда вызывает методы того контроллера интерфейса для уведомления его, когда интерфейс является экранным и когда пользователь взаимодействует со средствами управления.

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

willActivate когда Ваш интерфейс собирается стать видимым на Часах Apple, метод сообщает. Используйте тот метод, чтобы сделать любые последние обновления к Вашим средствам управления или запустить времена или другие задачи. (Не используйте его для Вашего прежде всего инициализация.) Используют соответствие didDeactivate метод для выполнения любой заключительной очистки.

В Средстве моделирования iOS WatchKit вызывает didDeactivate метод для текущего контроллера интерфейса, когда Вы блокируете средство моделирования путем выбора Hardware> Lock. При последующем разблокировании средства моделирования WatchKit вызывает тот контроллер интерфейса willActivate метод снова. Можно использовать эту возможность отладить код активации и деактивации.

Продвижение и сование контроллеров интерфейса

Приложения, использующие иерархический стиль навигации, должны продвинуть и вытолкать контроллеры интерфейса для упрощения той навигации. Иерархические интерфейсы в WatchKit ведут себя как интерфейсы навигации в iOS. Когда Вы захотите вывести на экран новое содержание, вызовите pushControllerWithName:context: метод для анимации нового контроллера интерфейса на экран. WatchKit обрабатывает все анимации, связанные с отображением нового контроллера интерфейса.

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

Если Вы предпочитаете использовать переходы для инициирования иерархической навигации между контроллерами интерфейса, WatchKit вызывает contextForSegueWithIdentifier:inTable:rowIndex: или contextForSegueWithIdentifier: метод на основе того, был ли источник перехода строкой таблицы или кнопкой. Используйте те методы для обеспечения, объект контекста должен был инициализировать новый контроллер интерфейса.

Представление контроллера интерфейса модально

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

Модальный интерфейс может содержать единственный контроллер интерфейса (который является наиболее популярным способом использования), или это может содержать многократные контроллеры интерфейса в основанном на странице расположении. Рассмотрите использование основанного на странице модального интерфейса, прося, чтобы пользователь выбрал из числа нескольких различных вариантов.

Если модальный контроллер интерфейса не имеет заголовка, его заголовок установлен в строку Cancel по умолчанию. Можно установить значение этой строки в раскадровке или изменить его во время выполнения с помощью setTitle: метод. Когда пользователь касается строки заголовка, WatchKit автоматически отклоняет модальный интерфейс, не принимая дальнейшие меры.

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

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

Табличные 1Interface атрибуты контроллера

Атрибут

Описание

Идентификатор

Имя контроллера интерфейса. Используйте это имя для указания который контроллер интерфейса продвинуть или представить.

Заголовок

Строка заголовка присвоилась к контроллеру интерфейса. Можно установить это значение программно с помощью setTitle: метод.

Начальный контроллер

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

Скрывается при загрузке

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

Фон

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

Режим

Режим содержания для фонового изображения. Этот режим определяет, как фоновое изображение масштабирует или заполняет экран и ведет себя таким же образом как константы для UIViewContentMode ввести.

Анимационный

Булево значение, указывающее, начинает ли анимированное фоновое изображение выполнять свою анимацию, автоматически будучи загруженным. Установите значение в Да, если Вы хотите, чтобы анимация запустилась автоматически; установите его в No, если Вы предпочитаете запускать анимацию программно.

Цвет

Цвет фона, который будет выведен на экран позади содержания сцены.

Вставки

Сумма пространства (в точках) для вставки между краями контроллера интерфейса и его содержания. Выбор Custom позволяет Вам указать различные значения для вершины, нижней части, оставленной, и правые края.

Интервал

Дополнительный интервал (в точках) для включения между элементами в контроллер интерфейса.

Разделение на подклассы примечаний

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

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

При реализации контроллера интерфейса для представления локальных или удаленных уведомлений, подкласса WKNotificationInterfaceController вместо этого.

Инициализация контроллера интерфейса
  • init () - init Определяемый инициализатор

    Возвращает инициализированный объект контроллера интерфейса.

    Объявление

    Swift

    init()

    Objective C

    - (instancetype)init

    Возвращаемое значение

    Инициализированный объект контроллера интерфейса.

    Обсуждение

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

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

    В основанном на странице интерфейсе все контроллеры интерфейса инициализируются передняя сторона, но только первый выведен на экран первоначально. Другие не выведены на экран, пока пользователь не перешел к соответствующей странице. Если Ваш контроллер интерфейса выводит на экран информацию, которая может измениться между инициализацией и дисплеем страницы, использовать willActivate метод для обновления содержания.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

    См. также

    – awakeWithContext:
    – willActivate

  • awakeWithContext (_:) - awakeWithContext:

    Инициализирует контроллер интерфейса с указанными данными контекста.

    Объявление

    Swift

    func awakeWithContext(_ context: AnyObject?)

    Objective C

    - (void)awakeWithContext:(id)context

    Параметры

    context

    Объект контекста (если таковые имеются) предоставленный предыдущим контроллером интерфейса. Этот параметр может быть nil. Если это не nil, Вы ответственны за сохранение ссылки на предоставленный объект и использование его для конфигурирования контроллера интерфейса.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Ответ на события активации
  • willActivate () - willActivate

    Вызванный, чтобы сообщить, что содержание контроллера интерфейса является экранным.

    Объявление

    Swift

    func willActivate()

    Objective C

    - (void)willActivate

    Обсуждение

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

    Активация может произойти в любое время, включая то, в то время как заблокирован iPhone пользователя. Если Ваше расширение WatchKit шифрует файлы с помощью защиты данных, знают, что те файлы не могли бы быть доступными, когда расширение работает, особенно при использовании NSFileProtectionComplete класс защиты. Для улучшения проблемы используйте различный класс защиты.

    Системные вызовы этот метод на основном потоке расширения Вашего WatchKit. super реализация этого метода ничего не делает.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • didDeactivate () - didDeactivate

    Вызванный, чтобы сообщить, что содержание контроллера интерфейса является теперь внеэкранным.

    Объявление

    Swift

    func didDeactivate()

    Objective C

    - (void)didDeactivate

    Обсуждение

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

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

    Системные вызовы этот метод на основном потоке расширения Вашего WatchKit. super реализация этого метода ничего не делает.

    В Средстве моделирования iOS WatchKit вызывает этот метод для текущего контроллера интерфейса при блокировке средства моделирования путем выбора Hardware> Lock. При последующем разблокировании средства моделирования WatchKit вызывает тот контроллер интерфейса willActivate метод снова. Можно использовать эту возможность отладить код активации и деактивации.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Реализация интерфейса навигации
  • pushControllerWithName (_: контекст:) - pushControllerWithName:context:

    Продвигает новый контроллер интерфейса на экран.

    Объявление

    Swift

    func pushControllerWithName(_ name: String, context context: AnyObject?)

    Objective C

    - (void)pushControllerWithName:(NSString *)name context:(id)context

    Параметры

    name

    Имя контроллера интерфейса Вы хотите вывести на экран. В Вашей раскадровке имя контроллера интерфейса сохранено в свойстве Identifier объекта, расположенном в инспекторе атрибутов.

    context

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

    Обсуждение

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

    Всегда вызывайте этот метод от основного потока расширения своего WatchKit.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • popController () - popController

    Выталкивает текущий контроллер интерфейса с экрана.

    Объявление

    Swift

    func popController()

    Objective C

    - (void)popController

    Обсуждение

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

    Всегда вызывайте этот метод от основного потока расширения своего WatchKit.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • popToRootController () - popToRootController

    Популярность все контроллеры интерфейса кроме начального контроллера интерфейса приложения.

    Объявление

    Swift

    func popToRootController()

    Objective C

    - (void)popToRootController

    Обсуждение

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

    Всегда вызывайте этот метод от основного потока расширения своего WatchKit.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Представление контроллеров интерфейса модально
  • presentControllerWithName (_: контекст:) - presentControllerWithName:context:

    Представляет единственный контроллер интерфейса модально.

    Объявление

    Swift

    func presentControllerWithName(_ name: String, context context: AnyObject?)

    Objective C

    - (void)presentControllerWithName:(NSString *)name context:(id)context

    Параметры

    name

    Имя контроллера интерфейса Вы хотите вывести на экран. В Вашей раскадровке имя контроллера интерфейса сохранено в свойстве Identifier объекта, расположенном в инспекторе атрибутов. Этот параметр не должен быть nil.

    context

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

    Обсуждение

    После вызова этого метода WatchKit загружает и инициализирует новый контроллер интерфейса и анимирует его в позицию поверх текущего контроллера интерфейса. Модальный интерфейс скользит с нижней части экрана, и полностью покройте предыдущий интерфейс.

    Заголовок модального интерфейса установлен в строку Cancel если представленный контроллер интерфейса явно не изменяет его с помощью setTitle: метод. Ответвление заголовка отклоняет интерфейс автоматически. Для отклонения интерфейса программно вызовите dismissController метод.

    Всегда вызывайте этот метод от основного потока расширения своего WatchKit.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • presentControllerWithNames (_: контексты:) - presentControllerWithNames:contexts:

    Представляет основанный на странице интерфейс модально.

    Объявление

    Swift

    func presentControllerWithNames(_ names: [AnyObject], contexts contexts: [AnyObject]?)

    Objective C

    - (void)presentControllerWithNames:(NSArray *)names contexts:(NSArray *)contexts

    Параметры

    names

    Массив строк, каждая из которых содержит имя контроллера интерфейса, который Вы хотите вывести на экран в основанном на странице интерфейсе. В Вашей раскадровке имя контроллера интерфейса сохранено в свойстве Identifier объекта, расположенном в инспекторе атрибутов. Порядок строк в массиве используется для устанавливания порядка соответствующих контроллеров интерфейса. Этот параметр не должен быть nil или пустой массив.

    contexts

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

    Каждый объект в массиве передается контроллеру интерфейса в том же индексе в names параметр.

    Обсуждение

    После вызова этого метода WatchKit загружает и инициализирует новые контроллеры интерфейса и анимирует их в позицию поверх текущего контроллера интерфейса. Модальный интерфейс скользит с нижней части экрана, и полностью покройте предыдущий интерфейс. WatchKit выводит на экран первый контроллер интерфейса в names выстройте первоначально. Пользователь может перейти к другим интерфейсам путем сильного удара горизонтально.

    Заголовок модального интерфейса установлен в строковую Отмену, если представленный контроллер интерфейса явно не изменяет его с помощью setTitle: метод. Ответвление заголовка отклоняет интерфейс автоматически. Для отклонения интерфейса программно вызовите dismissController метод.

    Всегда вызывайте этот метод от основного потока расширения своего WatchKit.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • dismissController () - dismissController

    Отклоняет текущий контроллер интерфейса от экрана.

    Объявление

    Swift

    func dismissController()

    Objective C

    - (void)dismissController

    Обсуждение

    Вызовите этот метод, когда Вы хотите отклонить контроллер интерфейса, который Вы представили модально. Всегда вызывайте этот метод от основного потока расширения своего WatchKit.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Навигация по основанному на странице интерфейсу
  • reloadRootControllersWithNames (_: контексты:) + reloadRootControllersWithNames:contexts:

    Загружает указанные контроллеры интерфейса и восстанавливает основанный на странице интерфейс приложения.

    Объявление

    Swift

    class func reloadRootControllersWithNames(_ names: [AnyObject], contexts contexts: [AnyObject]?)

    Objective C

    + (void)reloadRootControllersWithNames:(NSArray *)names contexts:(NSArray *)contexts

    Параметры

    names

    Массив NSString объекты, каждый из которых содержит идентификатор контроллера интерфейса в Вашем файле раскадровки. Порядок идентификаторов в массиве определяет порядок соответствующих контроллеров интерфейса в основанном на странице интерфейсе.

    contexts

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

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • becomeCurrentPage () - becomeCurrentPage

    Выводит на экран контроллер интерфейса в основанном на странице интерфейсе.

    Объявление

    Swift

    func becomeCurrentPage()

    Objective C

    - (void)becomeCurrentPage

    Обсуждение

    Используйте этот метод, чтобы заставить текущий контроллер интерфейса стать текущей страницей основанного на странице интерфейса. Текущий контроллер интерфейса должен быть установлен в основанном на странице интерфейсе. После вызова этого метода WatchKit анимирует контроллер интерфейса в представление.

    Всегда вызывайте этот метод от основного потока расширения своего WatchKit.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Управление основанными на переходе переходами
  • contextForSegueWithIdentifier (_:) - contextForSegueWithIdentifier:

    Когда кнопка касается, возвращает объект контекста для передачи указанному контроллеру интерфейса.

    Объявление

    Swift

    func contextForSegueWithIdentifier(_ segueIdentifier: String) -> AnyObject?

    Objective C

    - (id)contextForSegueWithIdentifier:(NSString *)segueIdentifier

    Параметры

    segueIdentifier

    Идентификатор инициированного перехода. При конфигурировании интерфейса укажите идентификатор для перехода в инспекторе Атрибутов.

    Возвращаемое значение

    Объект передать новому контроллеру интерфейса. Используйте этот объект передать важную информацию к новому контроллеру интерфейса, такому как данные, которые будут выведены на экран или любая соответствующая информация состояния. Можно возвратиться nil если Вы хотите, но так не рекомендуется выполнение.

    Обсуждение

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

    WatchKit вызывает этот метод на основном потоке расширения Вашего WatchKit. Реализация этого метода является дополнительной, но рекомендуется при использовании переходов в файле раскадровки. Вы не должны вызывать super в Вашей реализации. Для переходов, происходящих из строки таблицы, используйте contextForSegueWithIdentifier:inTable:rowIndex: метод вместо этого.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • contextsForSegueWithIdentifier (_:) - contextsForSegueWithIdentifier:

    Когда кнопка касается, возвращает объекты контекста для передачи основанному на странице набору контроллеров интерфейса.

    Объявление

    Swift

    func contextsForSegueWithIdentifier(_ segueIdentifier: String) -> [AnyObject]?

    Objective C

    - (NSArray *)contextsForSegueWithIdentifier:(NSString *)segueIdentifier

    Параметры

    segueIdentifier

    Идентификатор инициированного перехода. Укажите идентификатор для перехода в инспекторе Атрибутов при конфигурировании интерфейса.

    Возвращаемое значение

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

    Обсуждение

    При создании модального перехода от кнопки до ряда контроллеров интерфейса в основанном на странице расположении системные вызовы этот метод, когда инициирован тот переход. Используйте этот метод для обеспечения новых контроллеров интерфейса любыми контекстными данными, они должны вывести на экран свое содержание. Объекты в массиве передаются непосредственно awakeWithContext: метод соответствующих контроллеров интерфейса.

    WatchKit вызывает этот метод на основном потоке расширения Вашего WatchKit. Реализация этого метода является дополнительной, но рекомендуется при использовании переходов в файле раскадровки. Вы не должны вызывать super в Вашей реализации. Для переходов, происходящих из строки таблицы, используйте contextsForSegueWithIdentifier:inTable:rowIndex: метод вместо этого.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • contextForSegueWithIdentifier (_: inTable:rowIndex:) - contextForSegueWithIdentifier:inTable:rowIndex:

    Когда строка в таблице касается, возвращает объект контекста для передачи указанному контроллеру интерфейса.

    Объявление

    Swift

    func contextForSegueWithIdentifier(_ segueIdentifier: String, inTable table: WKInterfaceTable, rowIndex rowIndex: Int) -> AnyObject?

    Objective C

    - (id)contextForSegueWithIdentifier:(NSString *)segueIdentifier inTable:(WKInterfaceTable *)table rowIndex:(NSInteger)rowIndex

    Параметры

    segueIdentifier

    Идентификатор инициированного перехода. Укажите идентификатор для перехода в инспекторе Атрибутов при конфигурировании интерфейса.

    table

    Объект таблицы, содержащий коснувшуюся строку.

    rowIndex

    Основанный на нуле индекс строки, коснувшейся пользователем.

    Возвращаемое значение

    Объект передать новому контроллеру интерфейса. Используйте этот объект передать важную информацию к новому контроллеру интерфейса, такому как данные для отображения или любая соответствующая информация состояния. Можно указать nil если Вы хотите, но так не рекомендуется выполнение.

    Обсуждение

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

    Этот метод вызывают на основном потоке расширения Вашего WatchKit. Реализация этого метода является дополнительной, но рекомендуется при использовании переходов в файле раскадровки. Вы не должны вызывать super в Вашей реализации. Для переходов, происходящих из кнопки, используйте contextsForSegueWithIdentifier: метод вместо этого.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • contextsForSegueWithIdentifier (_: inTable:rowIndex:) - contextsForSegueWithIdentifier:inTable:rowIndex:

    Когда строка в таблице касается, возвращает объекты контекста для передачи основанному на странице набору контроллеров интерфейса.

    Объявление

    Swift

    func contextsForSegueWithIdentifier(_ segueIdentifier: String, inTable table: WKInterfaceTable, rowIndex rowIndex: Int) -> [AnyObject]?

    Objective C

    - (NSArray *)contextsForSegueWithIdentifier:(NSString *)segueIdentifier inTable:(WKInterfaceTable *)table rowIndex:(NSInteger)rowIndex

    Параметры

    segueIdentifier

    Идентификатор инициированного перехода. При конфигурировании интерфейса укажите идентификатор для перехода в инспекторе Атрибутов.

    table

    Объект таблицы, содержащий коснувшуюся строку.

    rowIndex

    Основанный на нуле индекс строки, коснувшейся пользователем.

    Возвращаемое значение

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

    Обсуждение

    При создании модального перехода от строки таблицы до ряда контроллеров интерфейса в основанном на странице расположении системные вызовы этот метод, когда инициирован тот переход. Используйте этот метод для обеспечения новых контроллеров интерфейса любыми контекстными данными, они должны вывести на экран свое содержание. Объекты в массиве передаются непосредственно awakeWithContext: метод соответствующих контроллеров интерфейса.

    Этот метод вызывают на основном потоке расширения Вашего WatchKit. Реализация этого метода является дополнительной, но рекомендуется при использовании переходов в файле раскадровки. Вы не должны вызывать super в Вашей реализации. Для переходов, происходящих из кнопки, используйте contextsForSegueWithIdentifier: метод вместо этого.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Обработка ввода текста
  • presentTextInputControllerWithSuggestions (_: allowedInputMode:completion:) - presentTextInputControllerWithSuggestions:allowedInputMode:completion:

    Выводит на экран модальный интерфейс для того, чтобы собрать ввод текста от пользователя.

    Объявление

    Swift

    func presentTextInputControllerWithSuggestions(_ suggestions: [AnyObject]?, allowedInputMode inputMode: WKTextInputMode, completion completion: ([AnyObject]!) -> Void)

    Objective C

    - (void)presentTextInputControllerWithSuggestions:(NSArray *)suggestions allowedInputMode:(WKTextInputMode)inputMode completion:(void (^)(NSArray *results))completion

    Параметры

    suggestions

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

    inputMode

    Тип ввода для разрешения. Для списка возможных значений посмотрите WKTextInputMode.

    completion

    Блок для выполнения после пользователя отклоняет модальный интерфейс. Этот блок не имеет никакого возвращаемого значения и берет следующий параметр:

    results

    Массив, содержащий ввод от пользователя, или nil если пользователь отменил работу. Когда массив предоставлен, значение в массиве обычно NSString объект, представляющий ввод текста. Массив может также содержать изображение emoji, упакованное как NSData объект. Можно использовать объект данных создать соответствие UIImage объект.

    Обсуждение

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

    Когда пользователь принимает значение или отменяет ввод, контроллер ввода текста отклоняет себя и затем выполняет блок в completion параметр на основном потоке расширения WatchKit. Используйте блок, чтобы получить принятое значение и применить его к Вашему содержанию. Контроллер интерфейса представления активируется, прежде чем блок выполняется.

    Всегда вызывайте этот метод от основного потока расширения своего WatchKit.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • dismissTextInputController () - dismissTextInputController

    Отклоняет контроллер ввода текста, не возвращая текста.

    Объявление

    Swift

    func dismissTextInputController()

    Objective C

    - (void)dismissTextInputController

    Обсуждение

    Используйте этот метод для отмены работы ввода текста, не принимая ввода от пользователя. Отклонение контроллера интерфейса анимирует его от экрана и не вызывает связанный блок завершения.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Обработка выборов строки таблицы
  • таблица (_: didSelectRowAtIndex:) - table:didSelectRowAtIndex:

    Вызванный, чтобы сообщить, что пользователь выбрал строку в таблице.

    Объявление

    Swift

    func table(_ table: WKInterfaceTable, didSelectRowAtIndex rowIndex: Int)

    Objective C

    - (void)table:(WKInterfaceTable *)table didSelectRowAtIndex:(NSInteger)rowIndex

    Параметры

    table

    Объект таблицы, строка которого была выбрана.

    rowIndex

    Основанный на нуле индекс выбранной строки.

    Обсуждение

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

    Этот метод вызывают на основном потоке расширения Вашего WatchKit. Реализация метода является дополнительной.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Конфигурирование контекстного меню
  • addMenuItemWithItemIcon (_: title:action:) - addMenuItemWithItemIcon:title:action:

    Добавляет действие к контекстному меню с помощью предоставленного системой значка.

    Объявление

    Swift

    func addMenuItemWithItemIcon(_ itemIcon: WKMenuItemIcon, title title: String, action action: Selector)

    Objective C

    - (void)addMenuItemWithItemIcon:(WKMenuItemIcon)itemIcon title:(NSString *)title action:(SEL)action

    Параметры

    itemIcon

    Идентификатор стандартного системного значка. Этот параметр не должен быть nil. Для списка возможных значений посмотрите Menu Images.

    title

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

    action

    Метод действия, который вызовут, когда касается действие. Метод должен быть определен на текущем объекте контроллера интерфейса. Этот параметр не должен быть nil.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • addMenuItemWithImageNamed (_: title:action:) - addMenuItemWithImageNamed:title:action:

    Добавляет действие к контекстному меню с помощью существующего ресурса изображения в комплекте приложений WatchKit.

    Объявление

    Swift

    func addMenuItemWithImageNamed(_ imageName: String, title title: String, action action: Selector)

    Objective C

    - (void)addMenuItemWithImageNamed:(NSString *)imageName title:(NSString *)title action:(SEL)action

    Параметры

    imageName

    Имя изображения, которое будет загружено из Вашего пакета приложения WatchKit. Включайте расширение файла в имя. Этот параметр не должен быть nil.

    title

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

    action

    Метод действия, который вызовут, когда касается действие. Метод должен быть определен на текущем объекте контроллера интерфейса. Этот параметр не должен быть nil.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • addMenuItemWithImage (_: title:action:) - addMenuItemWithImage:title:action:

    Добавляет действие к контекстному меню при помощи изображения, предоставленного Вашим расширением WatchKit.

    Объявление

    Swift

    func addMenuItemWithImage(_ image: UIImage, title title: String, action action: Selector)

    Objective C

    - (void)addMenuItemWithImage:(UIImage *)image title:(NSString *)title action:(SEL)action

    Параметры

    image

    Шаблонное изображение, которое будет использоваться для действия. Только альфа-канал изображения используется. Этот параметр не должен быть nil. Для получения информации о размерностях для изображений меню см. Инструкции по Интерфейсу пользователя Часов Apple.

    title

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

    action

    Метод действия, который вызовут, когда касается действие. Метод должен быть определен на текущем объекте контроллера интерфейса. Этот параметр не должен быть nil.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • clearAllMenuItems () - clearAllMenuItems

    Удаляет все программно добавленные действия из контекстного меню.

    Объявление

    Swift

    func clearAllMenuItems()

    Objective C

    - (void)clearAllMenuItems

    Обсуждение

    Используйте этот метод для удаления всех пунктов меню, что Вы добавили использование addMenuItemWithImage:title:action: или addMenuItemWithImageNamed:title:action: метод. Этот метод не удаляет пункты меню, которые Вы сконфигурировали в файле раскадровки.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Установка заголовка дисплея
  • setTitle (_:) - setTitle:

    Устанавливает заголовок интерфейса.

    Объявление

    Swift

    func setTitle(_ title: String?)

    Objective C

    - (void)setTitle:(NSString *)title

    Параметры

    title

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

    Обсуждение

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

    Для локализации заголовка используйте значение в title параметр как ключ поиска для строки в Вашем Localizable.strings файл. Если Вы не включаете локализованный набор строк с тем ключом в Вашем комплекте приложений WatchKit, WatchKit использует значение в title непосредственно.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Координирование действия Хэндофф
  • updateUserActivity (_: userInfo:webpageURL:) - updateUserActivity:userInfo:webpageURL:

    Сообщает текущее действие приложения к системе.

    Объявление

    Swift

    func updateUserActivity(_ type: String, userInfo userInfo: [NSObject : AnyObject]?, webpageURL webpageURL: NSURL?)

    Objective C

    - (void)updateUserActivity:(NSString *)type userInfo:(NSDictionary *)userInfo webpageURL:(NSURL *)webpageURL

    Параметры

    type

    Тип действия, которое будет продолжаться. Значение является определенной разработчиками строкой в формате обратного DNS условно, например, com.myCompany.myEditor.editing. Этот параметр не должен быть nil или пустая строка.

    userInfo

    Словарь, содержащий специфичную для приложения информацию состояния, должен был продолжать действие на другом устройстве. Ключи и значения в словаре должны иметь следующие типы: NSArray, NSData, NSDate, NSDictionary, NSNull, NSNumber, NSSet, или NSString.

    webpageURL

    URL, содержащий веб-страницу для загрузки в браузере для продолжения действия. Схема URL должна быть http или https. Любая другая схема выдает исключение.

    Обсуждение

    Используйте этот метод для публикации текущего действия приложения так, чтобы это могло быть обработано соответственно. При вызове этого метода необходимо указать значение для userInfo параметр, webpageURL параметр или оба. Вызовите этот метод в следующих ситуациях:

    • В Вашем контроллере интерфейса взгляда вызовите этот метод и обеспечьте a userInfo словарь с информацией о том, что выводит на экран взгляд. Если пользователь касается Вашего взгляда, что контекстная информация передается Вашему приложению так, чтобы это могло сконфигурировать свой интерфейс соответственно.

    • Вызовите этот метод для передачи текущего действия с помощью Хэндофф. Система поставляет информацию iPhone пользователя, который может распространить информацию к другим устройствам пользователя. Для получения дополнительной информации о поддержке Хэндофф, см. Руководство по программированию Хэндофф.

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

    См. также

    – handleUserActivity:

  • invalidateUserActivity () - invalidateUserActivity

    Лишает законной силы новое пользовательское действие.

    Объявление

    Swift

    func invalidateUserActivity()

    Objective C

    - (void)invalidateUserActivity

    Обсуждение

    Используйте этот метод для лишения законной силы действия, которое больше не должно выполняться.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • handleUserActivity (_:) - handleUserActivity:

    Реагирует на Handoff-связанное действие.

    Объявление

    Swift

    func handleUserActivity(_ userInfo: [NSObject : AnyObject]?)

    Objective C

    - (void)handleUserActivity:(NSDictionary *)userInfo

    Параметры

    userInfo

    Словарь, содержащий данные о действии. При запуске приложения от его взгляда WatchKit устанавливает этот параметр на словарь, который взгляд передал updateUserActivity:userInfo:webpageURL: метод.

    Обсуждение

    Реализуйте этот метод в начальном контроллере интерфейса своего приложения и используйте его для ответа на Handoff-связанное действие. Когда Ваше приложение запускается в результате действия Хэндофф, WatchKit вызывает этот метод на начальном контроллере интерфейса приложения. Если Ваше приложение использует основанный на странице интерфейс, WatchKit вызывает этот метод для каждого контроллера интерфейса, который является частью Вашего начального интерфейса. Ваши контроллеры интерфейса должны каждый посмотреть на userInfo словарь и решает что действия взять. Например, контроллер интерфейса в основанном на странице интерфейсе мог бы сделать себя текущей страницей.

    Реализация по умолчанию этого метода ничего не делает. При переопределении этого метода не вызывать super.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

    См. также

    – updateUserActivity:userInfo:webpageURL:

Получение интерфейсных размерностей
  • contentFrame Свойство

    Прямоугольник кадра раньше выводил на экран содержание Вашего приложения. (только для чтения)

    Объявление

    Swift

    var contentFrame: CGRect { get }

    Objective C

    @property(nonatomic, readonly) CGRect contentFrame

    Обсуждение

    Прямоугольник в этом свойстве указан в точках. Этот прямоугольник может отличаться, чем экранные границы.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Ответ на уведомления
  • handleActionWithIdentifier (_: forRemoteNotification:) - handleActionWithIdentifier:forRemoteNotification:

    Поставляет удаленную полезную нагрузку уведомления и выбранное пользователями действие к контроллеру интерфейса.

    Объявление

    Swift

    func handleActionWithIdentifier(_ identifier: String?, forRemoteNotification remoteNotification: [NSObject : AnyObject])

    Objective C

    - (void)handleActionWithIdentifier:(NSString *)identifier forRemoteNotification:(NSDictionary *)remoteNotification

    Параметры

    identifier

    Действие выбрано пользователем. Эта строка является идентификатором, присвоенным действию в регистрационное время. Когда пользователь запускает приложение, не касаясь одной из кнопок действий, этот параметр устанавливается на пустую строку.

    remoteNotification

    Словарь полезной нагрузки уведомления нажатия. Этот параметр содержит данные, отправленные с уведомлением нажатия. Для получения информации о содержании этого словаря см. Локальное и Удаленное Руководство по программированию Уведомления.

    Обсуждение

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

    Если Ваше содержание приложения для iOS поддерживает интерактивные уведомления, identifier параметр может содержать идентификатор действия для коснувшейся кнопки. Используйте то значение для выполнения требуемого действия. Если identifier параметр содержит пустую строку, означающую, что пользователь запустил Ваше приложение WatchKit от интерфейса уведомления, не выбирая определенное действие.

    Системные вызовы этот метод на основном потоке расширения Вашего WatchKit. super реализация этого метода ничего не делает.

    Для получения информации о том, как поддерживать интерактивные уведомления в Вашем приложении для iOS, см. Локальное и Удаленное Руководство по программированию Уведомления. Для получения информации о том, как вывести на экран пользовательский интерфейс для уведомлений, см. Руководство по программированию Часов Apple.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • handleActionWithIdentifier (_: forLocalNotification:) - handleActionWithIdentifier:forLocalNotification:

    Поставляет локальную полезную нагрузку уведомления и выбранное пользователями действие к контроллеру интерфейса.

    Объявление

    Swift

    func handleActionWithIdentifier(_ identifier: String?, forLocalNotification localNotification: UILocalNotification)

    Objective C

    - (void)handleActionWithIdentifier:(NSString *)identifier forLocalNotification:(UILocalNotification *)localNotification

    Параметры

    identifier

    Действие выбрано пользователем. Эта строка является идентификатором, присвоенным действию в регистрационное время. Когда пользователь запускает приложение, не касаясь одной из кнопок действий, этот параметр устанавливается на пустую строку.

    localNotification

    Локальное уведомление возражает, что инициировал уведомление.

    Обсуждение

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

    Если Ваше содержание приложения для iOS поддерживает интерактивные уведомления, identifier параметр может содержать идентификатор действия для коснувшейся кнопки. Используйте то значение для выполнения требуемого действия. Если identifier параметр содержит пустую строку, означающую, что пользователь запустил Ваше приложение WatchKit от интерфейса уведомления, не выбирая определенное действие.

    Системные вызовы этот метод на основном потоке расширения Вашего WatchKit. super реализация этого метода ничего не делает.

    Для получения информации о том, как поддерживать интерактивные уведомления в Вашем приложении для iOS, см. Локальное и Удаленное Руководство по программированию Уведомления. Для получения информации о том, как вывести на экран пользовательский интерфейс для уведомлений, см. Руководство по программированию Часов Apple.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Связь с Родительским приложением для iOS
  • openParentApplication (_: ответ:) + openParentApplication:reply:

    Открывает содержание приложения для iOS и отправляет указанные данные в него.

    Объявление

    Swift

    class func openParentApplication(_ userInfo: [NSObject : AnyObject], reply reply: (([NSObject : AnyObject]!, NSError!) -> Void)?) -> Bool

    Objective C

    + (BOOL)openParentApplication:(NSDictionary *)userInfo reply:(void (^)(NSDictionary *replyInfo, NSError *error))reply

    Параметры

    userInfo

    Словарь, содержащий данные для передачи приложению для iOS. Используйте этот словарь для передачи информации приложению для iOS так, чтобы это могло выполнить любые необходимые задачи. Содержание словаря должно быть сериализуемым к файлу списка свойств. Этот параметр не должен быть nil.

    reply

    Блок для получения ответа от содержания приложения для iOS. Можно указать nil для этого параметра. Этот блок не имеет никакого возвращаемого значения и берет следующие параметры:

    replyInfo

    Словарь ответа, предоставленный приложением для iOS.

    error

    Ошибочное указание объекта, если проблема произошла или nil если не было никакой ошибки.

    Возвращаемое значение

    YEStrue если запрос был отправлен успешно или NOfalse если не был отправлен запрос.

    Обсуждение

    Используйте этот метод для передачи с содержанием приложения для iOS. Вызов метода заставляет iOS запускать приложение в фоновом режиме (по мере необходимости) и вызывать application:handleWatchKitExtensionRequest:reply: метод его делегата приложения. Тот метод имеет следующую подпись:

    - (void)application:(UIApplication *)application handleWatchKitExtensionRequest:(NSDictionary *)userInfo reply:(void(^)(NSDictionary *replyInfo))reply

    Делегат приложения получает словарь, который Вы передаете в userInfo параметр и использование это для обработки безотносительно запроса Вы сделали. Если это обеспечивает ответ, WatchKit выполняет блок, который Вы обеспечили в reply параметр на основной очереди приложения Вашего WatchKit. При вызове этого метода многократно в быстрой преемственности вызовы сериализируются так, чтобы каждый последующий вызов был задержан, пока ответ от предыдущего вызова не получен.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Константы
  • Значки меню

    Шаблонные изображения, которые можно использовать для меню.

    Объявление

    Swift

    enum WKMenuItemIcon : Int { case Accept case Add case Block case Decline case Info case Maybe case More case Mute case Pause case Play case Repeat case Resume case Share case Shuffle case Speaker case Trash }

    Objective C

    typedef WKMenuItemIcon : NSInteger { WKMenuItemIconAccept , // checkmark WKMenuItemIconAdd , // '+' WKMenuItemIconBlock , // circle w/ slash WKMenuItemIconDecline , // 'x' WKMenuItemIconInfo , // 'i' WKMenuItemIconMaybe , // '?' WKMenuItemIconMore , // '...' WKMenuItemIconMute , // speaker w/ slash WKMenuItemIconPause , // pause button WKMenuItemIconPlay , // play button WKMenuItemIconRepeat , // looping arrows WKMenuItemIconResume , // circular arrow WKMenuItemIconShare , // share icon WKMenuItemIconShuffle , // swapped arrows WKMenuItemIconSpeaker , // speaker icon WKMenuItemIconTrash , // trash icon } WKMenuItemIcon;

    Константы

    • Accept

      WKMenuItemIconAccept

      Значок, указывающий действие для принятия событие или элемент. image: ../Art/SPMenuItemAccept-regular_2x.png

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

    • Add

      WKMenuItemIconAdd

      Значок, указывающий действие для добавления элемента. image: ../Art/SPMenuItemAdd-regular_2x.png

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

    • Block

      WKMenuItemIconBlock

      Значок, указывающий действие, чтобы блокировать или предотвратить что-то. image: ../Art/SPMenuItemBlock-regular_2x.png

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

    • Decline

      WKMenuItemIconDecline

      Значок, указывающий действие, чтобы уменьшиться или отменить событие. image: ../Art/SPMenuItemDecline-regular_2x.png

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

    • Info

      WKMenuItemIconInfo

      Значок, указывающий действие для получения больше информации. image: ../Art/SPMenuItemInfo-regular_2x.png

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

    • Maybe

      WKMenuItemIconMaybe

      Значок, указывающий ответ возможно для действия. image: ../Art/SPMenuItemMaybe-regular_2x.png

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

    • More

      WKMenuItemIconMore

      Значок, указывающий, что больше действий или опций доступны. image: ../Art/SPMenuItemMore-regular_2x.png

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

    • Mute

      WKMenuItemIconMute

      Значок, указывающий действие для отключения звука звука. image: ../Art/SPMenuItemMute-regular_2x.png

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

    • Pause

      WKMenuItemIconPause

      Значок, указывающий действие для приостановки воспроизведение. image: ../Art/SPMenuItemPause-regular_2x.png

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

    • Play

      WKMenuItemIconPlay

      Значок, указывающий действие для игры некоторое содержание. image: ../Art/SPMenuItemPlay-regular_2x.png

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

    • Repeat

      WKMenuItemIconRepeat

      Значок, указывающий, который играл содержание, должен повториться в цикле. image: ../Art/SPMenuItemRepeat-regular_2x.png

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

    • Resume

      WKMenuItemIconResume

      Значок, указывающий действие, чтобы продолжить играть некоторое содержание. image: ../Art/SPMenuItemResume-regular_2x.png

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

    • Share

      WKMenuItemIconShare

      Значок, указывающий действие для совместного использования содержание. image: ../Art/SPMenuItemShare-regular_2x.png

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

    • Shuffle

      WKMenuItemIconShuffle

      Значок, указывающий действие для перестановки содержание. image: ../Art/SPMenuItemShuffle-regular_2x.png

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

    • Speaker

      WKMenuItemIconSpeaker

      Значок, указывающий аудиовыход. image: ../Art/SPMenuItemSpeaker-regular_2x.png

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

    • Trash

      WKMenuItemIconTrash

      Значок, указывающий действие для удаления некоторое содержание. image: ../Art/SPMenuItemTrash-regular_2x.png

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

    Обсуждение

    Используйте эти константы с addMenuItemWithItemIcon:title:action: метод для конфигурирования действий для меню контроллера интерфейса.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • WKTextInputMode

    Режимы ввода поддерживаются контроллером ввода текста.

    Объявление

    Swift

    enum WKTextInputMode : Int { case Plain case AllowEmoji case AllowAnimatedEmoji }

    Objective C

    typedef enum WKTextInputMode : NSInteger { WKTextInputModePlain, WKTextInputModeAllowEmoji, WKTextInputModeAllowAnimatedEmoji, }WKTextInputMode;

    Константы

    • Plain

      WKTextInputModePlain

      Текст из предписания и предложений только. Не позволяйте emoji никакого вида.

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

    • AllowEmoji

      WKTextInputModeAllowEmoji

      Текст из предписания и предложений плюс не анимированный emoji.

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

    • AllowAnimatedEmoji

      WKTextInputModeAllowAnimatedEmoji

      Текст из предписания и предложений и плюс анимированный и плюс не анимированный emoji.

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • Ошибочный домен

    Домен для ошибок WatchKit.

    Объявление

    Swift

    let WatchKitErrorDomain: String

    Objective C

    NSString * const WatchKitErrorDomain

    Константы

    • WatchKitErrorDomain

      Домен для ошибок WatchKit. Это значение используется в NSError класс.

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

  • WatchKitErrorCode

    Коды ошибки, о которых сообщает WatchKit.

    Объявление

    Swift

    enum WatchKitErrorCode : Int { case UnknownError case ApplicationDelegateWatchKitRequestReplyNotCalledError }

    Objective C

    typedef enum WatchKitErrorCode : NSInteger { WatchKitUnknownError = 1, WatchKitApplicationDelegateWatchKitRequestReplyNotCalledError = 2, } WatchKitErrorCode;

    Константы

    • UnknownError

      WatchKitUnknownError

      Неизвестная ошибка. Когда точная причина отказа не могла быть определена, об этом коде ошибки сообщают.

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

    • ApplicationDelegateWatchKitRequestReplyNotCalledError

      WatchKitApplicationDelegateWatchKitRequestReplyNotCalledError

      Безразличная ошибка делегата. Когда Вы вызываете, WatchKit сообщает об этой ошибке openParentApplication:reply: метод и делегат приложения для iOS, получающий сбои сообщения для возврата ответа.

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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