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

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

Разработчик

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

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

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

UITextViewDelegate

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


Не применимый

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


Swift

import UIKit

Objective C

@import UIKit;

Доступность


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

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

  • Если редактирование должно начаться в указанном текстовом представлении, спрашивает делегат.

    Объявление

    Swift

    optional func textViewShouldBeginEditing(_ textView: UITextView) -> Bool

    Objective C

    - (BOOL)textViewShouldBeginEditing:(UITextView *)textView

    Параметры

    textView

    Текстовое представление, для которого редактирование собирается начаться.

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

    YEStrue если должен инициироваться сеанс редактирования; иначе, NOfalse запрещать редактирование.

    Обсуждение

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

    Реализация этого метода делегатом является дополнительной. Если это не существует, редактируя доходы, как будто возвратился этот метод YEStrue.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • Говорит делегату, что началось редактирование указанного текстового представления.

    Объявление

    Swift

    optional func textViewDidBeginEditing(_ textView: UITextView)

    Objective C

    - (void)textViewDidBeginEditing:(UITextView *)textView

    Параметры

    textView

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • Если редактирование должно остановиться в указанном текстовом представлении, спрашивает делегат.

    Объявление

    Swift

    optional func textViewShouldEndEditing(_ textView: UITextView) -> Bool

    Objective C

    - (BOOL)textViewShouldEndEditing:(UITextView *)textView

    Параметры

    textView

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

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

    YEStrue если должно остановиться редактирование; иначе, NOfalse если должен продолжаться сеанс редактирования

    Обсуждение

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

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

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

    Реализация этого метода делегатом является дополнительной. Если это не присутствует, первое состояние респондента оставлено, как будто возвратился этот метод YEStrue.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • Говорит делегату, что закончилось редактирование указанного текстового представления.

    Объявление

    Swift

    optional func textViewDidEndEditing(_ textView: UITextView)

    Objective C

    - (void)textViewDidEndEditing:(UITextView *)textView

    Параметры

    textView

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

    Объявление

    Swift

    optional func textView(_ textView: UITextView, shouldChangeTextInRange range: NSRange, replacementText text: String) -> Bool

    Objective C

    - (BOOL)textView:(UITextView *)textView shouldChangeTextInRange:(NSRange)range replacementText:(NSString *)text

    Параметры

    textView

    Текстовое представление, содержащее изменения.

    range

    Текущий диапазон выбора. Если длина диапазона 0, range отражает текущую точку вставки. Если пользователь нажимает клавишу Delete, длина диапазона равняется 1, и объект пустой строки заменяет тот отдельный символ.

    text

    Текст для вставки.

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

    YEStrue если старый текст должен быть заменен новым текстом; NOfalse если должна быть прервана заменяющая работа.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • Говорит делегату, что текст или атрибуты в указанном текстовом представлении были изменены пользователем.

    Объявление

    Swift

    optional func textViewDidChange(_ textView: UITextView)

    Objective C

    - (void)textViewDidChange:(UITextView *)textView

    Параметры

    textView

    Текстовое представление, содержащее изменения.

    Обсуждение

    Текстовое представление вызывает этот метод в ответ на инициируемые пользователями изменения в тексте. Этот метод не вызывают в ответ на программно инициируемые изменения.

    Реализация этого метода является дополнительной.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

    Объявление

    Swift

    optional func textViewDidChangeSelection(_ textView: UITextView)

    Objective C

    - (void)textViewDidChangeSelection:(UITextView *)textView

    Параметры

    textView

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

    Обсуждение

    Реализация этого метода является дополнительной. Можно использовать selectedRange свойство текста просматривает для получения нового выбора.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

    Объявление

    Swift

    optional func textView(_ textView: UITextView, shouldInteractWithTextAttachment textAttachment: NSTextAttachment, inRange characterRange: NSRange) -> Bool

    Objective C

    - (BOOL)textView:(UITextView *)textView shouldInteractWithTextAttachment:(NSTextAttachment *)textAttachment inRange:(NSRange)characterRange

    Параметры

    textView

    Текстовое представление, содержащее текстовое присоединение.

    textAttachment

    Текстовое присоединение.

    characterRange

    Диапазон символов, содержащий текстовое присоединение.

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

    YEStrue если должно быть позволено взаимодействие с текстовым присоединением; NOfalse если не должно быть позволено взаимодействие.

    Обсуждение

    Если пользователь касается или длинные нажатия текстовое присоединение и, текстовое представление вызывает этот метод image свойство не nil. Реализация этого метода является дополнительной. Можно использовать этот метод для инициирования действия в дополнение к отображению текстового присоединения, встроенного с текстом.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • Если указанное текстовое представление должно позволить взаимодействие с пользователем с данным URL в данном диапазоне текста, спрашивает делегат.

    Объявление

    Swift

    optional func textView(_ textView: UITextView, shouldInteractWithURL URL: NSURL, inRange characterRange: NSRange) -> Bool

    Objective C

    - (BOOL)textView:(UITextView *)textView shouldInteractWithURL:(NSURL *)URL inRange:(NSRange)characterRange

    Параметры

    textView

    Текстовое представление, содержащее текстовое присоединение.

    URL

    URL, который будет обработан.

    characterRange

    Диапазон символов, содержащий URL.

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

    YEStrue если должно быть позволено взаимодействие с URL; NOfalse если не должно быть позволено взаимодействие.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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