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

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

Разработчик

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

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

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

WKInterfaceGroup

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

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

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

Swift

import WatchKit

Objective C

@import WatchKit;

Доступность

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

A WKInterfaceGroup объект является контейнером для одного или более интерфейсных объектов. Группа концептуально подобна суперпредставлению в UIKit, в котором она обрабатывает расположение для своих содержавших элементов. Группа располагает элементы вертикально или горизонтально в Вашем интерфейсе. У групп также есть конфигурируемые атрибуты, использующиеся во время расположения для определения точного размещения элементов в группе. Можно даже вложить группы в других группах для управления более сложными макетами. Сохраните ссылку на объект группы, когда Вы захотите внести изменения в появление группы во время выполнения.

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

Swift

  • @IBOutlet weak var myGroup: WKInterfaceGroup!

Objective C

  • @property (weak, nonatomic) IBOutlet WKInterfaceGroup* myGroup;

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

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

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

Табличные 1WatchKit атрибуты группы

Атрибут

Описание

Расположение

Направление макета для элементов в группе. Можно расположить элементы горизонтально и вертикально.

Вставки

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

Интервал

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

Фон

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

Режим

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

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

Булево значение, указывающее, animatable ли фоновое изображение. Установите значение в Да для конфигурирования параметров анимации, включая ее продолжительность (в секундах) и запускается ли оно сразу, когда родительский контроллер интерфейса появляется на экране. Анимации запустились во время загрузки, выполняемое постоянно в цикле.

Цвет

Цвет фона для группы. Можно также установить это значение программно с помощью setBackgroundColor: метод.

Радиус

Угловой радиус для применения к прямоугольнику группы. Содержание в группе отсекается к угловому радиусу. Если Вы не указываете пользовательское значение, WatchKit применяет радиус с 6 точками по умолчанию.

Установка появления группы
  • setBackgroundColor (_:) - setBackgroundColor:

    Изменяет цвет фона для контейнера группы.

    Объявление

    Swift

    func setBackgroundColor(_ color: UIColor?)

    Objective C

    - (void)setBackgroundColor:(UIColor *)color

    Параметры

    color

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

    Обсуждение

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

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setBackgroundImage (_:) - setBackgroundImage:

    Изменяет фоновое изображение контейнера группы к указанному изображению.

    Объявление

    Swift

    func setBackgroundImage(_ image: UIImage?)

    Objective C

    - (void)setBackgroundImage:(UIImage *)image

    Параметры

    image

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

    Обсуждение

    Изображение, которое Вы указываете, должно быть отправлено с iPhone пользователя на Часы Apple, прежде чем это сможет быть выведено на экран.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setBackgroundImageData (_:) - setBackgroundImageData:

    Изменяет фоновое изображение контейнера группы к изображению в указанном объекте данных.

    Объявление

    Swift

    func setBackgroundImageData(_ imageData: NSData?)

    Objective C

    - (void)setBackgroundImageData:(NSData *)imageData

    Параметры

    imageData

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

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setBackgroundImageNamed (_:) - setBackgroundImageNamed:

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

    Объявление

    Swift

    func setBackgroundImageNamed(_ imageName: String?)

    Objective C

    - (void)setBackgroundImageNamed:(NSString *)imageName

    Параметры

    imageName

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

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • setCornerRadius (_:) - setCornerRadius:

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

    Объявление

    Swift

    func setCornerRadius(_ cornerRadius: CGFloat)

    Objective C

    - (void)setCornerRadius:(CGFloat)cornerRadius

    Параметры

    cornerRadius

    Радиус (в точках) круга, привыкшего к раунду углы краев групп.

    Обсуждение

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

    Угловой радиус по умолчанию для групп является 6 точками.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

Анимация фонового изображения
  • startAnimating () - startAnimating

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

    Объявление

    Swift

    func startAnimating()

    Objective C

    - (void)startAnimating

    Обсуждение

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

    Если данные фонового изображения состоят из единственного изображения, этот метод ничего не делает.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • startAnimatingWithImagesInRange (_: duration:repeatCount:) - startAnimatingWithImagesInRange:duration:repeatCount:

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

    Объявление

    Swift

    func startAnimatingWithImagesInRange(_ imageRange: NSRange, duration duration: NSTimeInterval, repeatCount repeatCount: Int)

    Objective C

    - (void)startAnimatingWithImagesInRange:(NSRange)imageRange duration:(NSTimeInterval)duration repeatCount:(NSInteger)repeatCount

    Параметры

    imageRange

    Диапазон изображений, которые будут анимированы. Значение 0 указывает первое изображение в последовательности, значении 1 второе изображение, и т.д.

    duration

    Время (в секундах), по которому можно анимировать единственный цикл изображений. Положительные значения заставляют анимацию запускаться в первом кадре в последовательности и конце на последнем кадре. Отрицательные величины заставляют анимацию играть в обратном порядке и заканчиваться на первом кадре в последовательности.

    repeatCount

    Число раз для повторения цикла анимации. Указать 0 анимировать изображения неопределенно.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • stopAnimating () - stopAnimating

    Остановки любые происходящие анимации.

    Объявление

    Swift

    func stopAnimating()

    Objective C

    - (void)stopAnimating

    Обсуждение

    Если никакая анимация не происходит, этот метод ничего не делает.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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