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

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

Разработчик

Ссылка платформы UIKit ссылка класса UILabel

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

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

UILabel

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

Режим содержания по умолчанию UILabel класс UIViewContentModeRedraw. Этот режим заставляет представление перерисовывать свое содержание каждый раз его изменения ограничительного прямоугольника. Можно изменить этот режим путем изменения наследованного contentMode свойство класса.

Новые объекты метки сконфигурированы для игнорирования пользовательских событий и подпредставлений клипа по умолчанию. Если Вы хотите обработать события в пользовательском подклассе UILabel, необходимо явно изменить значение userInteractionEnabled свойство к YEStrue после инициализации объекта. Если Вы хотите позволить подпредставлениям расширяться вне границ метки, необходимо явно изменить значение метки clipsToBounds свойство к NOfalse.

Для получения информации об основных способах поведения представления см. Руководство по программированию Представления для iOS.

Для получения дополнительной информации о появлении и конфигурации поведения, посмотрите Метки в Каталоге Пользовательского интерфейса UIKit.

Доступ к текстовым атрибутам
  • text Свойство

    Текст выведен на экран меткой.

    Объявление

    Swift

    var text: String?

    Objective C

    @property(nonatomic, copy) NSString *text

    Обсуждение

    Эта строка nil по умолчанию.

    В iOS 6 и позже, присваивая новое значение этому свойству также заменяет значение attributedText свойство с тем же текстом, хотя без любых свойственных атрибутов стиля. Вместо этого стили метки новая строка с помощью shadowColor, textAlignment, и другие связанные со стилем свойства класса.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • attributedText Свойство

    Стилизованный текст выведен на экран меткой.

    Объявление

    Swift

    @NSCopying var attributedText: NSAttributedString!

    Objective C

    @property(nonatomic, copy) NSAttributedString *attributedText

    Обсуждение

    Это свойство nil по умолчанию. Присвоение нового значения к этому свойству также заменяет значение text свойство с теми же строковыми данными, хотя без любой информации о форматировании. Кроме того, присваивая новое значение обновляет значения в font, textColor, и другие связанные со стилем свойства так, чтобы они отразили информацию о стилях, запускающуюся в расположении 0 в приписанной строке.

    Для включения автокернинга в метке установить NSKernAttributeName из строки к [NSNull null].

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • font Свойство

    Шрифт текста.

    Объявление

    Swift

    var font: UIFont!

    Objective C

    @property(nonatomic, retain) UIFont *font

    Обсуждение

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

    Значение по умолчанию для этого свойства является системным шрифтом в размере 17 точек (использующий systemFontOfSize: метод класса UIFont). Значение для свойства может только быть установлено в не -nil значение; установка этого свойства к nil повышает исключение.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • textColor Свойство

    Цвет текста.

    Объявление

    Swift

    var textColor: UIColor!

    Objective C

    @property(nonatomic, retain) UIColor *textColor

    Обсуждение

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

    Значение по умолчанию для этого свойства является черным цветом (набор через blackColor метод класса UIColor). Значение для свойства может только быть установлено в не -nil значение; установка этого свойства к nil повышает исключение.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • textAlignment Свойство

    Метод для использования для выравнивания текста.

    Объявление

    Swift

    var textAlignment: NSTextAlignment

    Objective C

    @property(nonatomic) NSTextAlignment textAlignment

    Обсуждение

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

    Значение по умолчанию этого свойства NSTextAlignmentLeft.

    Специальные замечания

    В iOS 5 и ранее, тип этого свойства был UITextAlignment.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • lineBreakMode Свойство

    Метод для использования для обертывания и усечения текста метки.

    Объявление

    Swift

    var lineBreakMode: NSLineBreakMode

    Objective C

    @property(nonatomic) NSLineBreakMode lineBreakMode

    Обсуждение

    Если Вы не используете разработанный текст, это свойство применяется ко всей текстовой строке в text свойство. При использовании разработанного текста в iOS 6 или позже присваивание нового значения к этому свойству заставляет режим разрыва строки быть примененным к полноте строки в attributedText свойство. Если Вы хотите применить режим разрыва строки к только части текста, создать новую приписанную строку с информацией о требуемом стиле и связать его с меткой. Однако NSParagraphStyle свойства, такие как определенные NSLineBreakMode, применитесь ко всем абзацам (как определено для paragraphRangeForRange:), не слова в абзацах.

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

    Специальные замечания

    В iOS 5 и ранее, тип этого свойства был UILineBreakMode.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    adjustsFontSizeToFitWidth

  • enabled Свойство

    Включенное состояние для использования при рисовании текста метки.

    Объявление

    Swift

    var enabled: Bool

    Objective C

    @property(nonatomic, getter=isEnabled) BOOL enabled

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    adjustsFontSizeToFitWidth

Калибровка текста метки
  • adjustsFontSizeToFitWidth Свойство

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

    Объявление

    Swift

    var adjustsFontSizeToFitWidth: Bool

    Objective C

    @property(nonatomic) BOOL adjustsFontSizeToFitWidth

    Обсуждение

    Обычно, текст метки составлен со шрифтом, который Вы указываете в font свойство. Если это свойство установлено в YEStrue, однако, и текст в text свойство превышает ограничительный прямоугольник метки, получатель начинает сокращать размер шрифта до строковых адаптаций, или минимальный размер шрифта достигнут. В iOS 6 и ранее, это свойство является эффективным только когда numberOfLines свойство установлено в 1.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    шрифт
    minimumFontSize

  • adjustsLetterSpacingToFitWidth (iOS 7.0) Свойство

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

    Оператор осуждения

    Ручная мелодия вместо этого при помощи NSKernAttributeName влиять на отслеживание.

    Объявление

    Objective C

    @property(nonatomic) BOOL adjustsLetterSpacingToFitWidth

    Обсуждение

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

    Если значение этого свойства к YEStrue, метка для игнорирования значения значений, возвращенного tighteningFactorForTruncation метод любого NSParagraphStyle объекты связались с текстом метки.

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

    Objective C

    @import UIKit;

    Доступность

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

    Осуждаемый в iOS 7.0.

  • baselineAdjustment Свойство

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

    Объявление

    Swift

    var baselineAdjustment: UIBaselineAdjustment

    Objective C

    @property(nonatomic) UIBaselineAdjustment baselineAdjustment

    Обсуждение

    Если adjustsFontSizeToFitWidth свойство установлено в YEStrue, это свойство управляет поведением текстовых базовых линий в ситуациях, где требуется корректировка размера шрифта. Значение по умолчанию этого свойства UIBaselineAdjustmentAlignBaselines. Это свойство является эффективным только когда numberOfLines свойство установлено в 1.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    adjustsFontSizeToFitWidth

  • minimumScaleFactor Свойство

    Минимальный масштабный коэффициент поддерживается для текста метки.

    Объявление

    Swift

    var minimumScaleFactor: CGFloat

    Objective C

    @property(nonatomic) CGFloat minimumScaleFactor

    Обсуждение

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

    Значение по умолчанию этого свойства 0.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • minimumFontSize (iOS 6.0) Свойство

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

    Оператор осуждения

    Использовать minimumScaleFactor вместо этого.

    Объявление

    Objective C

    @property(nonatomic) CGFloat minimumFontSize

    Обсуждение

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

    Значение по умолчанию для этого свойства 0.0. При включении корректировки шрифта к метке необходимо всегда увеличивать эту стоимость. Это свойство является эффективным только когда numberOfLines свойство установлено в 1.

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

    Objective C

    @import UIKit;

    Доступность

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

    Осуждаемый в iOS 6.0.

    См. также

    adjustsFontSizeToFitWidth

  • numberOfLines Свойство

    Максимальное количество строк для использования для рендеринга текста.

    Объявление

    Swift

    var numberOfLines: Int

    Objective C

    @property(nonatomic) NSInteger numberOfLines

    Обсуждение

    Это свойство управляет максимальным количеством строк для использования для вмещения текста метки в его ограничительный прямоугольник. Значение по умолчанию для этого свойства равняется 1. Для удаления любого максимального предела и использования в качестве многих строк по мере необходимости, устанавливают значение этого свойства к 0.

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    включенный
    adjustsFontSizeToFitWidth
    sizeToFit (UIView)

Управление значениями выделения
  • highlightedTextColor Свойство

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

    Объявление

    Swift

    var highlightedTextColor: UIColor?

    Objective C

    @property(nonatomic, retain) UIColor *highlightedTextColor

    Обсуждение

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

    Значение по умолчанию этого свойства nil .

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    выделенный

  • highlighted Свойство

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

    Объявление

    Swift

    var highlighted: Bool

    Objective C

    @property(nonatomic, getter=isHighlighted) BOOL highlighted

    Обсуждение

    Установка этого свойства заставляет получатель перерисовывать с надлежащим состоянием выделения. Подкласс, реализовывая текстовую кнопку мог бы установить это свойство в YEStrue когда пользователь нажимает кнопку и установил ее в NOfalse в других случаях. Для выделения, которое будет нарисовано, highlightedTextColor свойство должно содержать не -nil значение.

    Значение по умолчанию этого свойства NOfalse.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    highlightedTextColor

Рисование тени
  • shadowColor Свойство

    Цвет тени текста.

    Объявление

    Swift

    var shadowColor: UIColor?

    Objective C

    @property(nonatomic, retain) UIColor *shadowColor

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    shadowOffset

  • shadowOffset Свойство

    Теневое смещение (измеренный в точках) для текста.

    Объявление

    Swift

    var shadowOffset: CGSize

    Objective C

    @property(nonatomic) CGSize shadowOffset

    Обсуждение

    Цвет тени должен быть не -nil для этого свойства, чтобы иметь любой эффект. Размер смещения по умолчанию (0,-1), который указывает теневую точку выше текста. Текстовые тени нарисованы с указанным смещением и цветом и никаким размыванием.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    shadowColor

Получение и расположение переопределений
  • textRectForBounds (_: limitedToNumberOfLines:) - textRectForBounds:limitedToNumberOfLines:

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

    Объявление

    Swift

    func textRectForBounds(_ bounds: CGRect, limitedToNumberOfLines numberOfLines: Int) -> CGRect

    Objective C

    - (CGRect)textRectForBounds:(CGRect)bounds limitedToNumberOfLines:(NSInteger)numberOfLines

    Параметры

    bounds

    Ограничительный прямоугольник получателя.

    numberOfLines

    Максимальное количество строк для использования для метки. Значение 0 указывает, что нет никакого максимального количества строк и что прямоугольник должен охватить весь текст.

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

    Вычисленный прямоугольник получения для текста метки.

    Обсуждение

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

    Если был предшествующий вызов к, этот метод может вызвать система sizeToFit или sizeThatFits: метод. Обратите внимание на то, что метки в UITableViewCell объекты измерены на основе размерностей ячейки, и не требуемого размера.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • drawTextInRect (_:) - drawTextInRect:

    Составляет текст получателя (или его тень) в указанном прямоугольнике.

    Объявление

    Swift

    func drawTextInRect(_ rect: CGRect)

    Objective C

    - (void)drawTextInRect:(CGRect)rect

    Параметры

    rect

    Прямоугольник, в котором можно составить текст.

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Получение ограничений макета
  • preferredMaxLayoutWidth Свойство

    Предпочтительная максимальная ширина (в точках) для многострочной метки.

    Объявление

    Swift

    var preferredMaxLayoutWidth: CGFloat

    Objective C

    @property(nonatomic) CGFloat preferredMaxLayoutWidth

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Установка и получение атрибутов
  • userInteractionEnabled Свойство

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

    Объявление

    Swift

    var userInteractionEnabled: Bool

    Objective C

    @property(nonatomic, getter=isUserInteractionEnabled) BOOL userInteractionEnabled

    Обсуждение

    Это свойство наследовано от UIView родительский класс. Этот класс изменяет значение по умолчанию этого свойства к NOfalse.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    userInteractionEnabled (UIView)

  • clipsToBounds Свойство

    Булево значение, определяющее, ограничены ли подпредставления границами представления.

    Объявление

    Objective C

    @property(nonatomic) BOOL clipsToBounds

    Обсуждение

    Это свойство наследовано от UIView родительский класс. Этот класс изменяет значение по умолчанию этого свойства к YEStrue.

    См. также

    clipsToBounds (UIView)