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

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

Разработчик

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

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

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

WKInterfaceLabel

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


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


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


Swift

import WatchKit

Objective C

@import WatchKit;

Доступность


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

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

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

Swift

  • @IBOutlet weak var myLabel: WKInterfaceLabel!

Objective C

  • @property (weak, nonatomic) IBOutlet WKInterfaceLabel* myLabel;

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

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

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

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

Табличные 1WatchKit атрибуты метки

Атрибут

Описание

Текст

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

Цвет текста

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

Шрифт

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

Минимальный масштаб

Сумма, которой шрифт может масштабироваться для размещения текста. Значения должны быть 1.0 или меньше. Указание значения 0 WatchKit причин для использования поведения масштабирования значения по умолчанию, позволяющего масштабироваться к 0.8 из исходного размера шрифта.

Выравнивание

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

Строки

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

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

    Объявление

    Swift

    func setText(_ text: String?)

    Objective C

    - (void)setText:(NSString *)text

    Параметры

    text

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

    Обсуждение

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

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

    См. также

    – setAttributedText:

  • Выбирает цвет для применения к строкам обычного текста.

    Объявление

    Swift

    func setTextColor(_ color: UIColor?)

    Objective C

    - (void)setTextColor:(UIColor *)color

    Параметры

    color

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

    Обсуждение

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

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

    Объявление

    Swift

    func setAttributedText(_ attributedText: NSAttributedString?)

    Objective C

    - (void)setAttributedText:(NSAttributedString *)attributedText

    Параметры

    attributedText

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

    Обсуждение

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

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

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

    См. также

    – setText: