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

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

Разработчик

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

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

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

UITextInput

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

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

Классы, принимающие UITextInput протокол (и соответствуют наследованным протоколам) взаимодействует с системой ввода текста и таким образом получает функции, такие как автоисправление и многоступенчатый ввод текста для их документов. (Многоступенчатый ввод текста требуется, когда язык является идеограммой, и клавиатура является фонетической.)

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

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

UITextInput протокол является центром совокупности классов и протоколов для интеграции относящихся к обработке текстов приложений с системой ввода текста. Другие части этой совокупности являются следующим:

  • UITextPosition и UITextRange классы — Все UITextInput- приспосабливание классам документа должно создать пользовательские подклассы этих классов. Объект UITextPosition представляет позицию в текстовом контейнере. A UITextRange объект, инкапсулирующий начало и окончание UITextPosition объекты, представляет диапазон символов в текстовом контейнере.

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

  • UITextInputDelegate протокол — система ввода текста автоматически присваивает своего собственного делегата ввода текста (который соответствует этому протоколу) к UITextInput-соответствующему объекту документа. Через этого делегата ввода текста объект документа сообщает системе ввода текста изменений в тексте и выборе.

  • UIKeyInput протокол — Реализованный для получения возможностей ввода текста и удаления в точке вставки.

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

Запускаясь в iOS 5.1, когда пользователь выбирает ввод предписания на поддерживаемом устройстве, система автоматически вставляет распознанные фразы в представление текущего текста. Методы в UITextInput протокол позволяет Вашему приложению реагировать на завершение предписания, как описано в Использовании Предписания. Можно использовать объект UIDictationPhrase класс для получения строки, представляющей фразу пользователь, продиктовал. В случае неоднозначных результатов предписания объект фразы предписания обеспечивает массив, содержащий альтернативные строки.

Замена и возврат текста
  • textInRange (_:) - textInRange: Требуемый

    Возвратите текст в указанном диапазоне. (требуемый)

    Объявление

    Swift

    func textInRange(_ range: UITextRange) -> String

    Objective C

    - (NSString *)textInRange:(UITextRange *)range

    Параметры

    range

    Диапазон текста в документе.

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

    Подстрока документа, находящегося в пределах указанного диапазона.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – replaceRange:withText:

  • replaceRange (_: withText:) - replaceRange:withText: Требуемый

    Замените текст в документе, который находится в указанном диапазоне. (требуемый)

    Объявление

    Swift

    func replaceRange(_ range: UITextRange, withText text: String)

    Objective C

    - (void)replaceRange:(UITextRange *)range withText:(NSString *)text

    Параметры

    range

    Диапазон текста в документе.

    text

    Строка для замены текста в range.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – textInRange:

  • shouldChangeTextInRange (_: replacementText:) - shouldChangeTextInRange:replacementText:

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

    Объявление

    Swift

    optional func shouldChangeTextInRange(_ range: UITextRange, replacementText text: String) -> Bool

    Objective C

    - (BOOL)shouldChangeTextInRange:(UITextRange *)range replacementText:(NSString *)text

    Параметры

    range

    Диапазон текста в документе.

    text

    Предложенный текст для замены текста в range.

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

    YEStrue если текст должен быть изменен или NOfalse если это не должно.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Работа с отмеченным и выделенным текстом
  • selectedTextRange Требуемое свойство

    Диапазон выделенного текста в документе. (требуемый)

    Объявление

    Swift

    @NSCopying var selectedTextRange: UITextRange? { get set }

    Objective C

    @property(readwrite, copy) UITextRange *selectedTextRange

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    markedTextRange
    empty (UITextRange)

  • markedTextRange Свойство

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

    Объявление

    Swift

    var markedTextRange: UITextRange? { get }

    Objective C

    @property(nonatomic, readonly) UITextRange *markedTextRange

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    markedTextStyle
    – setMarkedText:selectedRange:
    – unmarkText

  • markedTextStyle Требуемое свойство

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

    Объявление

    Swift

    var markedTextStyle: [NSObject : AnyObject]! { get set }

    Objective C

    @property(nonatomic, copy) NSDictionary *markedTextStyle

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    markedTextRange
    – setMarkedText:selectedRange:
    – unmarkText

  • setMarkedText (_: selectedRange:) - setMarkedText:selectedRange: Требуемый

    Вставьте предоставленный текст, и отмечает его, чтобы указать, что это - часть активного входного сеанса. (требуемый)

    Объявление

    Swift

    func setMarkedText(_ markedText: String!, selectedRange selectedRange: NSRange)

    Objective C

    - (void)setMarkedText:(NSString *)markedText selectedRange:(NSRange)selectedRange

    Параметры

    markedText

    Текст, который будет отмечен.

    selectedRange

    Диапазон в markedText это указывает текущий выбор. Этот диапазон всегда относительно markedText.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    markedTextRange
    markedTextStyle
    – unmarkText

  • unmarkText () - unmarkText Требуемый

    Снимите выделение с в настоящее время отмечаемого текста. (требуемый)

    Объявление

    Swift

    func unmarkText()

    Objective C

    - (void)unmarkText

    Обсуждение

    После того, как этот метод вызывают, значение markedTextRange nil.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    markedTextRange
    – setMarkedText:selectedRange:

  • selectionAffinity Свойство

    Желаемое расположение для точки вставки.

    Объявление

    Swift

    optional var selectionAffinity: UITextStorageDirection { get set }

    Objective C

    @property(nonatomic) UITextStorageDirection selectionAffinity

    Обсуждение

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

    В реализации по умолчанию, если выбор не в конце строки, или если выбор в начале абзаца для пустой строки, принято прямое направление (UITextStorageDirectionForward); иначе, обратное направление UITextStorageDirectionBackward принят.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Вычислительные текстовые диапазоны и текстовые позиции

Оценка текстовых позиций
  • comparePosition (_: toPosition:) - comparePosition:toPosition: Требуемый

    Возвратитесь, как одна текстовая позиция выдерживает сравнение с другой текстовой позицией. (требуемый)

    Объявление

    Swift

    func comparePosition(_ position: UITextPosition, toPosition other: UITextPosition) -> NSComparisonResult

    Objective C

    - (NSComparisonResult)comparePosition:(UITextPosition *)position toPosition:(UITextPosition *)other

    Параметры

    position

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

    other

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – offsetFromPosition:toPosition:

  • offsetFromPosition (_: toPosition:) - offsetFromPosition:toPosition: Требуемый

    Возвратите число видимых символов между одной текстовой позицией и другой текстовой позицией. (требуемый)

    Объявление

    Swift

    func offsetFromPosition(_ fromPosition: UITextPosition, toPosition toPosition: UITextPosition) -> Int

    Objective C

    - (NSInteger)offsetFromPosition:(UITextPosition *)fromPosition toPosition:(UITextPosition *)toPosition

    Параметры

    fromPosition

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

    toPosition

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

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

    Число видимых символов между fromPosition и toPosition.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – comparePosition:toPosition:

Определение расположения и запись направления
  • positionWithinRange (_: farthestInDirection:) - positionWithinRange:farthestInDirection: Требуемый

    Возвратите текстовую позицию, которая является в самой дальней степени в данном направлении макета в диапазоне текста. (требуемый)

    Объявление

    Swift

    func positionWithinRange(_ range: UITextRange!, farthestInDirection direction: UITextLayoutDirection) -> UITextPosition!

    Objective C

    - (UITextPosition *)positionWithinRange:(UITextRange *)range farthestInDirection:(UITextLayoutDirection)direction

    Параметры

    range

    Объект текстового диапазона, разграничивающий диапазон текста в документе.

    direction

    Константа, указывающая направление расположения (право, оставленное, вниз).

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

    Позиционный текстом объект, идентифицирующий расположение в видимом тексте.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – characterRangeByExtendingPosition:inDirection:

  • characterRangeByExtendingPosition (_: косвенность:) - characterRangeByExtendingPosition:inDirection: Требуемый

    Возвратите текстовый диапазон от данной текстовой позиции до ее самой дальней степени в определенном направлении расположения. (требуемый)

    Объявление

    Swift

    func characterRangeByExtendingPosition(_ position: UITextPosition, inDirection direction: UITextLayoutDirection) -> UITextRange!

    Objective C

    - (UITextRange *)characterRangeByExtendingPosition:(UITextPosition *)position inDirection:(UITextLayoutDirection)direction

    Параметры

    position

    Позиционный текстом объект, идентифицирующий расположение в документе.

    direction

    Константа, указывающая направление расположения (право, оставленное, вниз).

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

    Объект текстового диапазона, представляющий расстояние от position до самой дальней степени в direction.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – positionWithinRange:farthestInDirection:

  • baseWritingDirectionForPosition (_: косвенность:) - baseWritingDirectionForPosition:inDirection: Требуемый

    Возвратите направление записи основы для позиции в тексте, входящем в определенное направление. (требуемый)

    Объявление

    Swift

    func baseWritingDirectionForPosition(_ position: UITextPosition, inDirection direction: UITextStorageDirection) -> UITextWritingDirection

    Objective C

    - (UITextWritingDirection)baseWritingDirectionForPosition:(UITextPosition *)position inDirection:(UITextStorageDirection)direction

    Параметры

    position

    Объект, идентифицирующий расположение в документе.

    direction

    Константа, указывающая направление хранения (вперед или назад).

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

    Константа, представляющая направление записи (например, слева направо или справа налево)

    Обсуждение

    Когда система ввода текста отправляет a, направление записи основы установлено ранее setBaseWritingDirection:forRange: обменивайтесь сообщениями к соответствующему объекту документа.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • setBaseWritingDirection (_: forRange:) - setBaseWritingDirection:forRange: Требуемый

    Установите направление записи основы для данного диапазона текста в документе. (требуемый)

    Объявление

    Swift

    func setBaseWritingDirection(_ writingDirection: UITextWritingDirection, forRange range: UITextRange!)

    Objective C

    - (void)setBaseWritingDirection:(UITextWritingDirection)writingDirection forRange:(UITextRange *)range

    Параметры

    writingDirection

    Константа, представляющая направление записи (например, слева направо или справа налево)

    range

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – baseWritingDirectionForPosition:inDirection:

Геометрия и методы тестирования хита
  • firstRectForRange (_:) - firstRectForRange: Требуемый

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

    Объявление

    Swift

    func firstRectForRange(_ range: UITextRange) -> CGRect

    Objective C

    - (CGRect)firstRectForRange:(UITextRange *)range

    Параметры

    range

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

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

    Первый прямоугольник в a range из текста. Вы могли бы использовать этот прямоугольник для рисования прямоугольника исправления. Когда диапазон охватывает многократные строки текста, «первое» на имя отсылает прямоугольник, включающий первую строку.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – caretRectForPosition:

  • caretRectForPosition (_:) - caretRectForPosition: Требуемый

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

    Объявление

    Swift

    func caretRectForPosition(_ position: UITextPosition!) -> CGRect

    Objective C

    - (CGRect)caretRectForPosition:(UITextPosition *)position

    Параметры

    position

    Объект, идентифицирующий расположение в документе.

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – firstRectForRange:

  • closestPositionToPoint (_:) - closestPositionToPoint: Требуемый

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

    Объявление

    Swift

    func closestPositionToPoint(_ point: CGPoint) -> UITextPosition!

    Objective C

    - (UITextPosition *)closestPositionToPoint:(CGPoint)point

    Параметры

    point

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

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

    Объект, определяющий местоположение позиции в документе, который является самым близким к point.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – closestPositionToPoint:withinRange:
    – characterRangeAtPoint:

  • selectionRectsForRange (_:) - selectionRectsForRange: Требуемый

    Возвращает массив выбора rects соответствие диапазону текста. (требуемый)

    Объявление

    Swift

    func selectionRectsForRange(_ range: UITextRange) -> [AnyObject]

    Objective C

    - (NSArray *)selectionRectsForRange:(UITextRange *)range

    Параметры

    range

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

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

    Массив UITextSelectionRect объекты, охватывающие выбор.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • closestPositionToPoint (_: withinRange:) - closestPositionToPoint:withinRange: Требуемый

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

    Объявление

    Swift

    func closestPositionToPoint(_ point: CGPoint, withinRange range: UITextRange!) -> UITextPosition!

    Objective C

    - (UITextPosition *)closestPositionToPoint:(CGPoint)point withinRange:(UITextRange *)range

    Параметры

    point

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

    range

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

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

    Объект, представляющий позицию символа в range это является самым близким к point.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – closestPositionToPoint:
    – characterRangeAtPoint:

  • characterRangeAtPoint (_:) - characterRangeAtPoint: Требуемый

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

    Объявление

    Swift

    func characterRangeAtPoint(_ point: CGPoint) -> UITextRange?

    Objective C

    - (UITextRange *)characterRangeAtPoint:(CGPoint)point

    Параметры

    point

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – closestPositionToPoint:
    – closestPositionToPoint:withinRange:

Делегат ввода текста и токенизатор ввода текста
  • inputDelegate Требуемое свойство

    Входной делегат, уведомляющийся, когда текст изменяется или когда изменяется выбор. (требуемый)

    Объявление

    Swift

    unowned(unsafe) var inputDelegate: UITextInputDelegate! { get set }

    Objective C

    @property(nonatomic, assign) id< UITextInputDelegate > inputDelegate

    Обсуждение

    Система ввода текста автоматически присваивает делегата в этом свойстве во время выполнения. Это - ответственность представления, принимающего UITextInput протокол для уведомления ввода делегирует в надлежащих соединениях.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • tokenizer Свойство

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

    Объявление

    Swift

    var tokenizer: UITextInputTokenizer { get }

    Objective C

    @property(nonatomic, readonly) id< UITextInputTokenizer > tokenizer

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Используя предписание
  • dictationRecordingDidEnd () - dictationRecordingDidEnd

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

    Объявление

    Swift

    optional func dictationRecordingDidEnd()

    Objective C

    - (void)dictationRecordingDidEnd

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • dictationRecognitionFailed () - dictationRecognitionFailed

    Вызванный, когда предписание закончилось, но отказавшее распознавание.

    Объявление

    Swift

    optional func dictationRecognitionFailed()

    Objective C

    - (void)dictationRecognitionFailed

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • insertDictationResult (_:) - insertDictationResult:

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

    Объявление

    Swift

    optional func insertDictationResult(_ dictationResult: [AnyObject])

    Objective C

    - (void)insertDictationResult:(NSArray *)dictationResult

    Параметры

    dictationResult

    Массив UIDictationPhrase объекты.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • insertDictationResultPlaceholder () - insertDictationResultPlaceholder

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

    Объявление

    Swift

    optional func insertDictationResultPlaceholder() -> AnyObject

    Objective C

    - (id)insertDictationResultPlaceholder

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

    Объект местозаполнителя для использования для идентификации результатов предписания. Это значение не должно быть nil.

    Обсуждение

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

    UIKit поддерживает сильную ссылку к Вашему объекту местозаполнителя до removeDictationResultPlaceholder:willInsertResult: метод вызывают. Необходимо реализовать и этот метод и removeDictationResultPlaceholder:willInsertResult: метод для заполнителей, которые будут использоваться.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • frameForDictationResultPlaceholder (_:) - frameForDictationResultPlaceholder:

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

    Объявление

    Swift

    optional func frameForDictationResultPlaceholder(_ placeholder: AnyObject!) -> CGRect

    Objective C

    - (CGRect)frameForDictationResultPlaceholder:(id)placeholder

    Параметры

    placeholder

    Объект местозаполнителя, предоставленный Вашим приложением и используемый для идентификации расположения результатов предписания.

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – insertDictationResultPlaceholder
    – removeDictationResultPlaceholder:willInsertResult:

  • removeDictationResultPlaceholder (_: willInsertResult:) - removeDictationResultPlaceholder:willInsertResult:

    Говорит представлению, что больше не необходим указанный объект местозаполнителя.

    Объявление

    Swift

    optional func removeDictationResultPlaceholder(_ placeholder: AnyObject, willInsertResult willInsertResult: Bool)

    Objective C

    - (void)removeDictationResultPlaceholder:(id)placeholder willInsertResult:(BOOL)willInsertResult

    Параметры

    placeholder

    Объект местозаполнителя, который больше не необходим.

    willInsertResult

    Значение этого параметра YEStrue если значение предписания было сгенерировано успешно или NOfalse если произошла ошибка.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Возврат текстовой информации о форматировании
  • textStylingAtPosition (_: косвенность:) - textStylingAtPosition:inDirection:

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

    Объявление

    Swift

    optional func textStylingAtPosition(_ position: UITextPosition, inDirection direction: UITextStorageDirection) -> [NSObject : AnyObject]!

    Objective C

    - (NSDictionary *)textStylingAtPosition:(UITextPosition *)position inDirection:(UITextStorageDirection)direction

    Параметры

    position

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

    direction

    Направление моделирования приписывает в текстовом хранении.

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

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

    Обсуждение

    Текстовая информация о форматировании может влиять, например, на появление прямоугольника исправления.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Согласование текстовой позиции и символьного смещения
  • positionWithinRange (_: atCharacterOffset:) - positionWithinRange:atCharacterOffset:

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

    Объявление

    Swift

    optional func positionWithinRange(_ range: UITextRange!, atCharacterOffset offset: Int) -> UITextPosition!

    Objective C

    - (UITextPosition *)positionWithinRange:(UITextRange *)range atCharacterOffset:(NSInteger)offset

    Параметры

    range

    Объект, указывающий диапазон текста в документе.

    offset

    Символьное смещение от запуска range.

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

    Объект, представляющий позицию в видимом тексте документа.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – characterOffsetOfPosition:withinRange:

  • characterOffsetOfPosition (_: withinRange:) - characterOffsetOfPosition:withinRange:

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

    Объявление

    Swift

    optional func characterOffsetOfPosition(_ position: UITextPosition, withinRange range: UITextRange) -> Int

    Objective C

    - (NSInteger)characterOffsetOfPosition:(UITextPosition *)position withinRange:(UITextRange *)range

    Параметры

    position

    Объект, идентифицирующий расположение в тексте документа.

    range

    Объект, указывающий диапазон текста в документе.

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

    Число символов в тексте документа, происходящих между position и начало range.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    – positionWithinRange:atCharacterOffset:

Возврат представления ввода текста
  • textInputView Свойство

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

    Объявление

    Swift

    optional var textInputView: UIView { get }

    Objective C

    @property(nonatomic, readonly) UIView *textInputView

    Обсуждение

    Представление, и составляющее текст и обеспечивающее систему координат для всех геометрических значений в этом протоколе. (Это обычно - экземпляр UITextInput- принятие класса.), Если это свойство не реализовано, первое представление в цепочке респондента выбрано.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Типы данных

  • UITextStorageDirection

    Направление текстового хранения.

    Объявление

    Swift

    enum UITextStorageDirection : Int { case Forward case Backward }

    Objective C

    typedef enum { UITextStorageDirectionForward = 0, UITextStorageDirectionBackward } UITextStorageDirection;

    Константы

    • Forward

      UITextStorageDirectionForward

      Хранение текста в прямом направлении.

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

    • Backward

      UITextStorageDirectionBackward

      Хранение текста в обратном направлении.

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

    Обсуждение

    Константы этого типа используются в качестве параметров baseWritingDirectionForPosition:inDirection: и textStylingAtPosition:inDirection: методы.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • UITextLayoutDirection

    Направление текстового расположения.

    Объявление

    Swift

    enum UITextLayoutDirection : Int { case Right case Left case Up case Down }

    Objective C

    typedef enum { UITextLayoutDirectionRight = 2, UITextLayoutDirectionLeft, UITextLayoutDirectionUp, UITextLayoutDirectionDown } UITextLayoutDirection;

    Константы

    • Right

      UITextLayoutDirectionRight

      Расположение текста вправо.

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

    • Left

      UITextLayoutDirectionLeft

      Расположение текста налево.

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

    • Up

      UITextLayoutDirectionUp

      Расположение текста в восходящем направлении.

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

    • Down

      UITextLayoutDirectionDown

      Расположение текста в нисходящем направлении.

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

    Обсуждение

    Константы этого типа используются в качестве параметров в positionFromPosition:inDirection:offset:, positionWithinRange:farthestInDirection:, и characterRangeByExtendingPosition:inDirection: методы.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • UITextWritingDirection

    Направление записи текста, на основе языка.

    Объявление

    Swift

    enum UITextWritingDirection : Int { case Natural case LeftToRight case RightToLeft }

    Objective C

    typedef enum { UITextWritingDirectionNatural = -1, UITextWritingDirectionLeftToRight = 0, UITextWritingDirectionRightToLeft, } UITextWritingDirection;

    Константы

    • Natural

      UITextWritingDirectionNatural

      Естественное направление записи, как определено алгоритмом Bidi.

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

    • LeftToRight

      UITextWritingDirectionLeftToRight

      Запись, идущая слева направо.

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

    • RightToLeft

      UITextWritingDirectionRightToLeft

      Запись, идущая справа налево.

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

    Обсуждение

    Константы этого типа возвращаются из baseWritingDirectionForPosition:inDirection: метод и используется в качестве параметров setBaseWritingDirection:forRange: метод.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Константы
  • Ключи словаря стилей

    Словарь, содержащий свойства, определяющие характеристики стиля текста.

    Объявление

    Swift

    let UITextInputTextBackgroundColorKey: String let UITextInputTextColorKey: String let UITextInputTextFontKey: String

    Objective C

    NSString *const UITextInputTextBackgroundColorKey; NSString *const UITextInputTextColorKey; NSString *const UITextInputTextFontKey;

    Константы

    • UITextInputTextBackgroundColorKey

      Цвет фона текста. Значение этого ключа является a UIColor объект.

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

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

    • UITextInputTextColorKey

      Цвет текста. Значение этого ключа является a UIColor объект.

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

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

    • UITextInputTextFontKey

      Шрифт текста. Значение этого ключа является a UIFont объект.

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

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

    Обсуждение

    Стиль NSDictionary объект используется для обеспечения информации о форматировании для отмеченного текста (markedTextStyle свойство) и для обеспечения текстовой информации о форматировании в определенной позиции (textStylingAtPosition:inDirection: метод).