UITextView

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

NSObject
UIResponder
UIView
UIScrollView
UITextView

NSObject
UIResponder
UIView
UIScrollView
UITextView

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

В iOS 6 и позже, этот класс поддерживает многократные стили текста посредством использования attributedText свойство. (Стилизованный текст не поддерживается в более ранних версиях iOS.) Установка значения для этого свойства заставляет текстовое представление использовать информацию о стилях, предоставленную в приписанной строке. Можно все еще использовать font, textColor, и textAlignment свойства для установки атрибутов стиля, но тех свойств применяются ко всему тексту в текстовом представлении.

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

Управление клавиатурой

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

Это - ответственность Вашего приложения отклонить клавиатуру во время Вашего выбора. Вы могли бы отклонить клавиатуру в ответ на определенное пользовательское действие, такое как пользователь, касающийся определенной кнопки в Вашем пользовательском интерфейсе. Для отклонения клавиатуры отправьте resignFirstResponder обменивайтесь сообщениями к текстовому представлению, которое в настоящее время является первым респондентом. Выполнение так вызывает текстовый объект представления закончить текущий сеанс редактирования (согласием объекта делегата) и скрыть клавиатуру.

Появление самой клавиатуры может быть настроено с помощью свойств, предоставленных UITextInputTraits протокол. Текстовые объекты представления реализуют этот протокол и поддерживают свойства, которые он определяет. Можно использовать эти свойства для указания типа клавиатуры (ASCII, Числа, URL, электронная почта и другие) для отображения. Можно также сконфигурировать основное поведение ввода текста клавиатуры, такой как, поддерживает ли это автоматическую капитализацию и исправление текста.

Уведомления клавиатуры

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

Для получения дополнительной информации об этих уведомлениях, см. их описания в Ссылке класса UIWindow.

Сохранение состояния

В iOS 6 и позже, если Вы присваиваете значение этому представлению restorationIdentifier свойство, это сохраняет следующую информацию:

Выбранный диапазон текста, как сообщается selectedRange свойство.
Состояние редактирования текстового представления, как сообщается editable свойство.

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

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

Инициализация


    
    init (frame:textContainer:)
    - initWithFrame:textContainer:

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

Объявление

Swift

init(frame frame: CGRect, textContainer textContainer: NSTextContainer?)

Objective C

- (instancetype)initWithFrame:(CGRect)frame textContainer:(NSTextContainer *)textContainer

Параметры

`frame`	Прямоугольник кадра текстового представления.
`textContainer`	Текстовый контейнер для использования для получателя (может быть `nil`).

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

Инициализированное текстовое представление.

Обсуждение

Это - определяемый инициализатор для UITextView объекты.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Конфигурирование текстовых атрибутов

text Свойство

Текст выведен на экран текстовым представлением.

Объявление

Swift

var text: String!

Objective C

@property(nonatomic, copy) NSString *text

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

attributedText
attributedText Свойство

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

Объявление

Swift

@NSCopying var attributedText: NSAttributedString!

Objective C

@property(nonatomic, copy) NSAttributedString *attributedText

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

var font: UIFont!

Objective C

@property(nonatomic, retain) UIFont *font

Обсуждение

Это свойство применяется ко всей текстовой строке. Стандартный шрифт является простым шрифтом Helvetica с 17 точками.

Примечание:

Можно получить информацию о шрифтах, доступных в системе с помощью методов UIFont класс.

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

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

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 свойство.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

backgroundColor (UIView)
editable Свойство

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

Объявление

Swift

var editable: Bool

Objective C

@property(nonatomic, getter=isEditable) BOOL editable

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

var allowsEditingTextAttributes: Bool

Objective C

@property(nonatomic) BOOL allowsEditingTextAttributes

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Типы данных, преобразованных в активируемый по щелчку URLs в текстовом представлении.

Объявление

Swift

var dataDetectorTypes: UIDataDetectorTypes

Objective C

@property(nonatomic) UIDataDetectorTypes dataDetectorTypes

Обсуждение

Можно использовать это свойство для указания типов данных (телефонные номера, http ссылки, и т.д.), который должен быть автоматически преобразован в активируемый по щелчку URLs в текстовом представлении. Когда щелкнувшийся, текстовое представление открывает приложение, ответственное за обработку типа URL, и передает его URL.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

var textAlignment: NSTextAlignment

Objective C

@property(nonatomic) NSTextAlignment textAlignment

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 2.0 и позже.
- hasText Доступный в iOS 2.0 через iOS 6.1

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

Объявление

Objective C

- (BOOL)hasText

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

YEStrue если получатель содержит текст или NOfalse если это не делает.

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

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 через iOS 6.1.
typingAttributes Свойство

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

Объявление

Swift

var typingAttributes: [NSObject : AnyObject]!

Objective C

@property(nonatomic, copy) NSDictionary *typingAttributes

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

доступный для редактирования
linkTextAttributes Свойство

Атрибуты для применения к ссылкам.

Объявление

Swift

var linkTextAttributes: [NSObject : AnyObject]!

Objective C

@property(nonatomic, copy) NSDictionary *linkTextAttributes

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Вставка текстовой области расположения контейнера в текстовой предметной области представления.

Объявление

Swift

var textContainerInset: UIEdgeInsets

Objective C

@property(nonatomic, assign) UIEdgeInsets textContainerInset

Обсуждение

Это свойство обеспечивает поля текста для текста, размеченного в текстовом представлении.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Работа с выбором

selectedRange Свойство

Текущий диапазон выбора получателя.

Объявление

Swift

var selectedRange: NSRange

Objective C

@property(nonatomic) NSRange selectedRange

Обсуждение

В iOS 2.2 и ранее, длина диапазона выбора всегда 0, указывая, что выбор является фактически точкой вставки. В iOS 3.0 и позже, длина диапазона выбора может быть ненулевой.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 2.0 и позже.
scrollRangeToVisible (_:) - scrollRangeToVisible:

Прокручивает получатель, пока текст в указанном диапазоне не видим.

Объявление

Swift

func scrollRangeToVisible(_ range: NSRange)

Objective C

- (void)scrollRangeToVisible:(NSRange)range

Параметры

range

Диапазон текста для прокрутки в представление.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

var clearsOnInsertion: Bool

Objective C

@property(nonatomic) BOOL clearsOnInsertion

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

var selectable: Bool

Objective C

@property(nonatomic, getter=isSelectable) BOOL selectable

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Доступ к делегату

delegate Свойство

Делегат получателя.

Объявление

Swift

unowned(unsafe) var delegate: UITextViewDelegate?

Objective C

@property(nonatomic, assign) id< UITextViewDelegate > delegate

Обсуждение

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

Для получения информации о методах, реализованных делегатом, посмотрите Ссылку на протокол UITextViewDelegate.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Замена системных входных представлений

inputView Свойство

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

Объявление

Swift

var inputView: UIView?

Objective C

@property(readwrite, retain) UIView *inputView

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Пользовательское вспомогательное представление для отображения, когда текстовое представление становится первым респондентом

Объявление

Swift

var inputAccessoryView: UIView?

Objective C

@property(readwrite, retain) UIView *inputAccessoryView

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

См. также

inputView

Доступ к текстовым объектам набора

layoutManager Свойство

Менеджер по расположению, размечающий текст для текстового контейнера получателя. (только для чтения)

Объявление

Swift

var layoutManager: NSLayoutManager { get }

Objective C

@property(nonatomic, readonly) NSLayoutManager *layoutManager

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

var textContainer: NSTextContainer { get }

Objective C

@property(nonatomic, readonly) NSTextContainer *textContainer

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Текстовый объект хранения, содержащий текст, выведен на экран в этом текстовом представлении. (только для чтения)

Объявление

Swift

var textStorage: NSTextStorage { get }

Objective C

@property(nonatomic, readonly, retain) NSTextStorage *textStorage

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Уведомления

UITextViewTextDidBeginEditingNotification UITextViewTextDidBeginEditingNotification

Уведомляет наблюдателей, что сеанс редактирования начался в текстовом представлении. Затронутое представление сохранено в object параметр уведомления. userInfo словарь не используется.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Уведомляет наблюдателей что текст в текстовом измененном представлении. Затронутое представление сохранено в object параметр уведомления. userInfo словарь не используется.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Уведомляет наблюдателей, что сеанс редактирования закончился для текстового представления. Затронутое представление сохранено в object параметр уведомления. userInfo словарь не используется.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

UITextView

Управление клавиатурой

Уведомления клавиатуры

Сохранение состояния

Инициализация

Объявление

Параметры

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

Обсуждение

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

Доступность

Конфигурирование текстовых атрибутов

Объявление

Обсуждение

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

Доступность

См. также

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

См. также

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

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

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

Доступность

Объявление

Обсуждение

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

Доступность

См. также

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Работа с выбором

Объявление

Обсуждение

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

Доступность

Объявление

Параметры

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность