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

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

Разработчик

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

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

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

WKInterfaceButton

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

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

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

Swift

import WatchKit

Objective C

@import WatchKit;

Доступность

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

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

Формат метода действия кнопки следующие:

Swift

  • @IBAction func buttonAction()

Objective C

  • - (IBAction)buttonAction

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

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

Swift

  • @IBOutlet weak var myButton: WKInterfaceButton!

Objective C

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

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

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

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

Атрибуты кнопки Table 1WatchKit

Атрибут

Описание

Содержание

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

Заголовок

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

Цвет (Кнопка)

Цвет для применения к заголовку кнопки.

Шрифт

Шрифт для применения к заголовку кнопки. Можно установить информацию о шрифтах программно с помощью setAttributedTitle: метод.

Включенный

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

Фон

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

Цвет (Фон)

Цвет фона для кнопки.

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

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

    Объявление

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

  • setAttributedTitle (_:) - setAttributedTitle:

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

    Объявление

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

Установка фона кнопки
  • setBackgroundColor (_:) - setBackgroundColor:

    Изменяет цвет фона кнопки.

    Объявление

    Swift

    func setBackgroundColor(_ color: UIColor?)

    Objective C

    - (void)setBackgroundColor:(UIColor *)color

    Параметры

    color

    Цвет заливки для использования для фона кнопки.

    Обсуждение

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

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

    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 удаляет существующее изображение. Можно указать данные изображения, содержащие повторные изображения, работающие как анимация.

    Обсуждение

    Данные изображения должны быть отправлены с 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 и позже.

Включение и отключение кнопки
  • setEnabled (_:) - setEnabled:

    Включает или отключает кнопку.

    Объявление

    Swift

    func setEnabled(_ enabled: Bool)

    Objective C

    - (void)setEnabled:(BOOL)enabled

    Параметры

    enabled

    Булево значение, указывающее, включена ли кнопка или отключена.

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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