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

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

Разработчик

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

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

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

WKInterfaceObject

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

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

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

Swift

import WatchKit

Objective C

@import WatchKit;

Доступность

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

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

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

Swift

  • @IBOutlet weak var button: WKInterfaceButton!

Objective C

  • @property (weak, nonatomic) IBOutlet WKInterfaceButton* myButton;

Во время выполнения WatchKit создает надлежащие интерфейсные объекты и присваивает их выходам в Вашем контроллере интерфейса.

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

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

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

Табличные 1WatchKit атрибуты объектов

Атрибут

Описание

Альфа

Непрозрачность объекта. Значение 1.0 представляет полностью непрозрачный и значение 0.0 представляет полностью прозрачный.

Скрытый

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

Установленный

Флажок, указывающий, установлен ли элемент для текущего устройства.

Горизонталь

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

Вертикальный

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

Width

Ширина объекта. Укажите фиксированную ширину или установите значение объекта быть процентом ширины его контейнера.

Высота

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

Сокрытие и показ объекта
  • setHidden (_:) - setHidden:

    Скрывает или показывает интерфейсный объект в Вашем пользовательском интерфейсе.

    Объявление

    Swift

    func setHidden(_ hidden: Bool)

    Objective C

    - (void)setHidden:(BOOL)hidden

    Параметры

    hidden

    Булево значение, указывающее видимость объекта. Указать YEStrue скрыть объект. Указать NOfalse показать его.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setAlpha (_:) - setAlpha:

    Устанавливает непрозрачность интерфейсного объекта.

    Объявление

    Swift

    func setAlpha(_ alpha: CGFloat)

    Objective C

    - (void)setAlpha:(CGFloat)alpha

    Параметры

    alpha

    Число с плавающей точкой в диапазоне 0.0 к 1.0, где 0.0 представляет полностью прозрачный и 1.0 представляет полностью непрозрачный.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Получение имени свойства
  • interfaceProperty Свойство

    Имя выхода в Вашем контроллере интерфейса, с которым связывается объект. (только для чтения)

    Объявление

    Swift

    var interfaceProperty: String { get }

    Objective C

    @property(nonatomic, readonly, copy) NSString *interfaceProperty

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Изменение размера объекта
  • setWidth (_:) - setWidth:

    Устанавливает абсолютную ширину (в точках) объекта.

    Объявление

    Swift

    func setWidth(_ width: CGFloat)

    Objective C

    - (void)setWidth:(CGFloat)width

    Параметры

    width

    Новая ширина объекта. Указать 0.0 вернуться к ширине, указанной в Вашем файле раскадровки.

    Обсуждение

    Вы не можете использовать этот метод для изменения ширины элементов разделителя или таблиц. Изменение ширины a WKInterfaceImage возразите заставляет содержание изображения масштабирующийся режим изменяться на UIViewContentModeScaleToFill.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setHeight (_:) - setHeight:

    Устанавливает абсолютную высоту (в точках) объекта.

    Объявление

    Swift

    func setHeight(_ height: CGFloat)

    Objective C

    - (void)setHeight:(CGFloat)height

    Параметры

    height

    Новая высота объекта. Указать 0.0 вернуться к высоте, указанной в Вашем файле раскадровки.

    Обсуждение

    Вы не можете использовать этот метод для изменения высоты элементов разделителя или таблиц. Изменение высоты a WKInterfaceImage возразите заставляет содержание изображения масштабирующийся режим изменяться на UIViewContentModeScaleToFill.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Конфигурирование атрибутов доступности
  • setAccessibilityLabel (_:) - setAccessibilityLabel:

    Устанавливает сжатую метку на объекте, идентифицирующем элемент доступности.

    Объявление

    Swift

    func setAccessibilityLabel(_ accessibilityLabel: String?)

    Objective C

    - (void)setAccessibilityLabel:(NSString *)accessibilityLabel

    Параметры

    accessibilityLabel

    Локализованная строка для идентификации объекта к системе доступности. Строка, которую Вы указываете, должна кратко описать цель объекта.

    Обсуждение

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

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setAccessibilityHint (_:) - setAccessibilityHint:

    Устанавливает описание того, что происходит при выполнении действия с элементом доступности.

    Объявление

    Swift

    func setAccessibilityHint(_ accessibilityHint: String?)

    Objective C

    - (void)setAccessibilityHint:(NSString *)accessibilityHint

    Параметры

    accessibilityHint

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

    Обсуждение

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

    Следуйте этим инструкциям для создания подсказки для интерфейсных объектов:

    • Подсказка должна быть очень краткой фразой, начинающейся с глагола, называющего результат действия, того, которое “Отклоняет интерфейс”. Чтобы избежать заставлять подсказку походить на команду, не начинайте фразу с обязательной формы глагола. Например, не устанавливайте подсказку для “Отклонения интерфейса”.

    • Не повторяйте тип действия в подсказке. Например, не создавайте подсказку, такую как “Касание для отклонения интерфейса”.

    • Не включайте информацию об объекте, вовлеченном в подсказку. Например, не создавайте подсказку, такую как “строка, выводящая на экран подробные данные об элементе”.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setAccessibilityValue (_:) - setAccessibilityValue:

    Устанавливает значение элемента доступности.

    Объявление

    Swift

    func setAccessibilityValue(_ accessibilityValue: String?)

    Objective C

    - (void)setAccessibilityValue:(NSString *)accessibilityValue

    Параметры

    accessibilityValue

    Новое значение для элемента доступности.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setIsAccessibilityElement (_:) - setIsAccessibilityElement:

    Наборы, является ли объект элементом доступности, к которому может получить доступ вспомогательное приложение.

    Объявление

    Swift

    func setIsAccessibilityElement(_ isAccessibilityElement: Bool)

    Objective C

    - (void)setIsAccessibilityElement:(BOOL)isAccessibilityElement

    Параметры

    isAccessibilityElement

    YEStrue если объект является элементом доступности или NOfalse если это не.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setAccessibilityTraits (_:) - setAccessibilityTraits:

    Устанавливает комбинацию черт доступности, лучше всего характеризующих элемент доступности.

    Объявление

    Swift

    func setAccessibilityTraits(_ accessibilityTraits: UIAccessibilityTraits)

    Objective C

    - (void)setAccessibilityTraits:(UIAccessibilityTraits)accessibilityTraits

    Параметры

    accessibilityTraits

    Черты, характеризующие этот элемент. Для списка черт и надлежащих комбинаций, посмотрите UIAccessibilityTraits.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setAccessibilityImageRegions (_:) - setAccessibilityImageRegions:

    Части Знаков изображения как отдельные доступные элементы.

    Объявление

    Swift

    func setAccessibilityImageRegions(_ accessibilityImageRegions: [AnyObject])

    Objective C

    - (void)setAccessibilityImageRegions:(NSArray *)accessibilityImageRegions

    Параметры

    accessibilityImageRegions

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

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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