UITextFieldDelegate

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

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

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

NSObjectProtocol
NSObject

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

Управление редактированием

textFieldShouldBeginEditing (_:) - textFieldShouldBeginEditing:

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

Объявление

Swift

optional func textFieldShouldBeginEditing(_ textField: UITextField) -> Bool

Objective C

- (BOOL)textFieldShouldBeginEditing:(UITextField *)textField

Параметры

textField

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

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

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

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

optional func textFieldDidBeginEditing(_ textField: UITextField)

Objective C

- (void)textFieldDidBeginEditing:(UITextField *)textField

Параметры

textField

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

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    textFieldShouldEndEditing (_:)
    - textFieldShouldEndEditing:

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

Объявление

Swift

optional func textFieldShouldEndEditing(_ textField: UITextField) -> Bool

Objective C

- (BOOL)textFieldShouldEndEditing:(UITextField *)textField

Параметры


      textField

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

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

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

Обсуждение

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

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

Примечание:

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

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

textFieldDidEndEditing (_:) - textFieldDidEndEditing:

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

Объявление

Swift

optional func textFieldDidEndEditing(_ textField: UITextField)

Objective C

- (void)textFieldDidEndEditing:(UITextField *)textField

Параметры

textField

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

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Редактирование текста текстового поля


    
    текстовое поле (_: shouldChangeCharactersInRange:replacementString:)
    - textField:shouldChangeCharactersInRange:replacementString:

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

Объявление

Swift

optional func textField(_ textField: UITextField, shouldChangeCharactersInRange range: NSRange, replacementString string: String) -> Bool

Objective C

- (BOOL)textField:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string

Параметры

`textField`	Текстовое поле, содержащее текст.
`range`	Диапазон символов, которые будут заменены
`string`	Замещающая строка.

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

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

textFieldShouldClear (_:) - textFieldShouldClear:

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

Объявление

Swift

optional func textFieldShouldClear(_ textField: UITextField) -> Bool

Objective C

- (BOOL)textFieldShouldClear:(UITextField *)textField

Параметры

textField

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

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

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

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

optional func textFieldShouldReturn(_ textField: UITextField) -> Bool

Objective C

- (BOOL)textFieldShouldReturn:(UITextField *)textField

Параметры

textField

Текстовое поле, кнопка возврата которого была нажата.

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

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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