Текстовые позиции и текстовые диапазоны

Клиентское приложение должно создать два класса, экземпляры которых представляют позиции и диапазоны текста в текстовом представлении. Эти классы должны быть подклассами UITextPosition и UITextRange.

Несмотря на то, что UITextPosition самостоятельно не объявляет методов или свойств, это - основная часть информации, обменянной между текстовым документом и системой ввода текста. Система ввода текста требует объекта представлять расположение в тексте вместо, скажем, целого числа или структуры. Кроме того, a UITextPosition когда строка, поддерживающая текст, имеет различное смещение к той позиции, объект может служить практической цели путем представления позиции в видимом тексте. Когда строка содержит невидимые символы форматирования, такой как с RTF и документами HTML или внедренными объектами, такими как присоединение, это происходит. Пользовательское UITextPosition класс может составить эти невидимые символы при определении местоположения строковых смещений видимых символов. В самом простом случае — документе простого текста без внедренных объектов — пользовательское UITextPosition объект может инкапсулировать единственное смещение или индексировать целое число.

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

Задачи объекта UITextInput

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

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

Методы реализованы a UITextInput объект может быть разделен на отличительные задачи:

• Возврат и замена текста текстовым диапазоном. Учитывая диапазон, или возвратите текст в том диапазоне или замените тот текст текстом, предоставленным системой ввода текста.

  • textInRange:

  • replaceRange:withText:

• Вычислительные текстовые диапазоны и текстовые позиции. Создайте и возвратите a UITextRange объект (или, просто, текстовый диапазон) данный две текстовых позиции; или создайте и возвратите a UITextPosition объект (или, просто, текстовая позиция) данный текстовую позицию и смещение.

  • positionFromPosition:offset:

  • positionFromPosition:inDirection:offset:

  • textRangeFromPosition:toPosition:

• Оценка текстовых позиций. Сравните две текстовых позиции или возвратите смещение от одной текстовой позиции до другого.

  • comparePosition:toPosition:

  • offsetFromPosition:toPosition:

• Ответ на вопросы расположения. Определите текстовую позицию или текстовый диапазон путем расширения в данном направлении макета.

  • positionWithinRange:farthestInDirection:

  • characterRangeByExtendingPosition:inDirection:

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

  • closestPositionToPoint:

  • closestPositionToPoint:withinRange:

  • characterRangeAtPoint:

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

  • firstRectForRange:

  • caretRectForPosition:

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

Когда изменения происходят в текстовом представлении вследствие внешних причин — т.е. они не вызываются вызовами от системы ввода текста — UITextInput объект должен отправить textWillChange:, textDidChange:, selectionWillChange:, и selectionDidChange: сообщения входному делегату (который это содержит ссылку на). Например, когда пользователи касаются текстового представления, и Вы устанавливаете диапазон выделенного текста для размещения точки вставки под пальцем, Вы отправили бы selectionWillChange: перед изменением выбранного диапазона, и Вы отправляете selectionDidChange: после изменения диапазона.

Токенизаторы

Токенизаторы являются объектами, определяющими, является ли текстовая позиция в или на границе единицы текста с данной гранулярностью. Когда запрошено системой ввода текста, токенизатор возвращает диапазоны единиц текста с данной гранулярностью или граничной текстовой позицией для единицы текста с данной гранулярностью. В настоящее время определяемые гранулярности являются символом, словом, предложением, абзацем, строкой и документом; enum константы UITextGranularity тип представляет эти гранулярности. Гранулярности единиц текста всегда оцениваются в отношении хранения или направления макета.

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

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

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

Подклассы UITextPosition и UITextRange

EditableCoreTextView создает пользовательский подкласс UITextPosition вызванный IndexedPosition и пользовательский подкласс UITextRange вызванный IndexedRange. Эти подклассы просто инкапсулируют единственное индексное значение и NSRange оцените на основе двух из тех индексов. Перечисление 10-3 показывает объявление этих классов.

Перечисление 10-3  , объявляющее IndexedPosition и IndexedRange классы

@interface IndexedPosition : UITextPosition {

    NSUInteger _index;

    id <UITextInputDelegate> _inputDelegate;

}

@property (nonatomic) NSUInteger index;

+ (IndexedPosition *)positionWithIndex:(NSUInteger)index;

@end

@interface IndexedRange : UITextRange {

    NSRange _range;

}

@property (nonatomic) NSRange range;

+ (IndexedRange *)rangeWithNSRange:(NSRange)range;

@end

Оба класса объявляют, что методы фабрики классов продают экземпляры. Перечисление 10-4 показывает реализацию этих методов, а также методов, объявленных UITextRange класс.

Перечисление 10-4  реализовывая IndexedPosition и IndexedRange классы

@implementation IndexedPosition

@synthesize index = _index;

+ (IndexedPosition *)positionWithIndex:(NSUInteger)index {

    IndexedPosition *pos = [[IndexedPosition alloc] init];

    pos.index = index;

    return [pos autorelease];

}

@end

@implementation IndexedRange

@synthesize range = _range;

+ (IndexedRange *)rangeWithNSRange:(NSRange)nsrange {

    if (nsrange.location == NSNotFound)

        return nil;

    IndexedRange *range = [[IndexedRange alloc] init];

    range.range = nsrange;

    return [range autorelease];

}

- (UITextPosition *)start {

    return [IndexedPosition positionWithIndex:self.range.location];

}

- (UITextPosition *)end {

        return [IndexedPosition positionWithIndex:(self.range.location + self.range.length)];

}

-(BOOL)isEmpty {

    return (self.range.length == 0);

}

@end

Вставка и удаление текста

Текстовое представление, принимающее UITextInput протокол должен также принять UIKeyInput протокол. Это означает, что должно реализовать insertText:, deleteBackward, и hasText методы, как обсуждено в Простом текстовом Вводе. Поскольку EditableCoreTextView класс принимает UITextInput, это должно также поддержать выбранные и отмеченные текстовые диапазоны (т.е. текущая стоимость selectedTextRange и markedTextRange свойства), поскольку текст введен и удален.

Перечисление 10-5 иллюстрирует как EditableCoreTextView когда текст введен, делает это. Если существует отмеченный текст, когда символ вводится, это заменяет отмеченный текст символом путем вызова replaceCharactersInRange:withString: метод на отступающей непостоянной строке. Если существует выбранный диапазон текста, он заменяет символы в том диапазоне с вводимым символом. Иначе, метод вставляет вводимый символ в каре.

Перечисление 10-5  , Вставляющее ввод текста в хранение и обновляющее выбранные и отмеченные диапазоны

- (void)insertText:(NSString *)text {

    NSRange selectedNSRange = _textView.selectedTextRange;

    NSRange markedTextRange = _textView.markedTextRange;

    if (markedTextRange.location != NSNotFound) {

        [_text replaceCharactersInRange:markedTextRange withString:text];

        selectedNSRange.location = markedTextRange.location + text.length;

        selectedNSRange.length = 0;

        markedTextRange = NSMakeRange(NSNotFound, 0);

    } else if (selectedNSRange.length > 0) {

        [_text replaceCharactersInRange:selectedNSRange withString:text];

        selectedNSRange.length = 0;

        selectedNSRange.location += text.length;

    } else {

        [_text insertString:text atIndex:selectedNSRange.location];

        selectedNSRange.location += text.length;

    }

    _textView.text = _text;

    _textView.markedTextRange = markedTextRange;

    _textView.selectedTextRange = selectedNSRange;

}

Даже при том, что структура deleteBackward метод, реализованный EditableCoreTextView идентично insertText: метод, существуют надлежащие различия в том, как корректируются выбранные и отмеченные текстовые диапазоны. Другое различие то, что deleteCharactersInRange: метод вызывают на отступающей непостоянной строке, а не replaceCharactersInRange:withString:.

Возврат и замена текста диапазоном

Любое текстовое представление, связывающееся с системой ввода текста, когда требуется, должно возвратить указанный диапазон текста и заменить диапазон текста с данной строкой. Классы в нашем примере, EditableCoreTextView и SimpleCoreTextView, поддержите синхронизируемые копии отступающего строкового объекта (EditableCoreTextView как a NSMutableString объект). Реализации textInRange: и replaceRange:withText: в Перечислении 10-6 вызывают надлежащее NSString методы на отступающей строке для выполнения их существенных функций.

  Реализации перечисления 10-6 textInRange: и replaceRange:withText:

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

{

    IndexedRange *r = (IndexedRange *)range;

    return ([_text substringWithRange:r.range]);

}

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

{

    IndexedRange *r = (IndexedRange *)range;

    NSRange selectedNSRange = _textView.selectedTextRange;

    if ((r.range.location + r.range.length) <= selectedNSRange.location) {

        selectedNSRange.location -= (r.range.length - text.length);

    } else {

        // Need to also deal with overlapping ranges.

    }

    [_text replaceCharactersInRange:r.range withString:text];

    _textView.text = _text;

    _textView.selectedTextRange = selectedNSRange;

}

Когда text свойство SimpleCoreTextView изменения (как показано в реализации replaceRange:withText:), SimpleCoreTextView размечает текст снова и перерисовывает его с помощью Базовых текстовых функций.

Поддержание выбранных и отмеченных текстовых диапазонов

Поскольку операции редактирования выполняются на выбранном и отмеченном тексте, система ввода текста часто запрашивает, чтобы текстовый возврат представления и установил диапазоны выбранного и отмеченного текста. Перечисление 10-7 показывает как EditableCoreTextView возвращает диапазоны выбранного и отмеченного текста путем реализации методов получателя для selectedTextRange и markedTextRangeсвойства.

Перечисление 10-7  Возвращая диапазоны выбранного и отмеченного текста

- (UITextRange *)selectedTextRange {

    return [IndexedRange rangeWithNSRange:_textView.selectedTextRange];

}

- (UITextRange *)markedTextRange {

    return [IndexedRange rangeWithNSRange:_textView.markedTextRange];

}

Метод установщика для selectedTextRange в Перечислении 10-8 просто устанавливает диапазон выделенного текста на встроенном текстовом представлении. setMarkedText:selectedRange: метод более сложен, потому что, как можно вспомнить, диапазон отмеченного текста содержит в нем диапазон выделенного текста (даже если диапазон просто идентифицирует каре), и эти диапазоны должны быть согласованы для отражения ситуации после вставки текста.

Перечисление 10-8  , Устанавливающее диапазон выделенного текста и устанавливающее отмеченный текст

- (void)setSelectedTextRange:(UITextRange *)range

{

    IndexedRange *r = (IndexedRange *)range;

    _textView.selectedTextRange = r.range;

}

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

    NSRange selectedNSRange = _textView.selectedTextRange;

    NSRange markedTextRange = _textView.markedTextRange;

    if (markedTextRange.location != NSNotFound) {

        if (!markedText)

            markedText = @"";

        [_text replaceCharactersInRange:markedTextRange withString:markedText];

        markedTextRange.length = markedText.length;

    } else if (selectedNSRange.length > 0) {

        [_text replaceCharactersInRange:selectedNSRange withString:markedText];

        markedTextRange.location = selectedNSRange.location;

        markedTextRange.length = markedText.length;

    } else {

        [_text insertString:markedText atIndex:selectedNSRange.location];

        markedTextRange.location = selectedNSRange.location;

        markedTextRange.length = markedText.length;

    }

    selectedNSRange = NSMakeRange(selectedRange.location + markedTextRange.location,

        selectedRange.length);

    _textView.text = _text;

    _textView.markedTextRange = markedTextRange;

    _textView.selectedTextRange = selectedNSRange;

}

Обратите внимание на то, что EditableCoreTextView заменяет текст путем вызова replaceCharactersInRange:withString: метод на его непостоянном строковом объекте, который это тогда присваивает text свойство встроенного текстового представления.

Часто вызываемые методы UITextInput

Когда пользовательские символы текста на клавиатуре и информацию от объекта, принимающего, когда те символы вводят текстовое хранение и размечаются, система ввода текста запрашивают UITextInput протокол. Три из более часто вызываемых методов textRangeFromPosition:toPosition:, offsetFromPosition:toPosition:, и positionFromPosition:offset:.

Системные вызовы ввода текста positionFromPosition:offset: для получения позиции в тексте, это - данное смещение от другой позиции. Перечисление 10-9 показывает как EditableCoreTextView реализации этот метод (который включает проверку диапазона).

  Реализация перечисления 10-9 positionFromPosition:offset:

- (UITextPosition *)positionFromPosition:(UITextPosition *)position offset:(NSInteger)offset {

    IndexedPosition *pos = (IndexedPosition *)position;

    NSInteger end = pos.index + offset;

    if (end > _text.length || end < 0)

        return nil;

    return [IndexedPosition positionWithIndex:end];

}

offsetFromPosition:toPosition: метод должен удовлетворить противоположный запрос и возвратить значение, указывающее смещение между двумя текстовыми позициями. EditableCoreTextView реализации это как показано в Перечислении 10-10.

  Реализация перечисления 10-10 offsetFromPosition:toPosition:

- (NSInteger)offsetFromPosition:(UITextPosition *)from toPosition:(UITextPosition *)toPosition {

    IndexedPosition *f = (IndexedPosition *)from;

    IndexedPosition *t = (IndexedPosition *)toPosition;

    return (t.index - f.index);

}

Наконец, система ввода текста часто просит у текстового представления текстовый диапазон, падающий между двумя текстовыми позициями. Перечисление 10-11 показывает реализацию textRangeFromPosition:toPosition: это возвращает этот диапазон.

  Реализация перечисления 10-11 textRangeFromPosition:toPosition:

- (UITextRange *)textRangeFromPosition:(UITextPosition *)fromPosition

          toPosition:(UITextPosition *)toPosition {

    IndexedPosition *from = (IndexedPosition *)fromPosition;

    IndexedPosition *to = (IndexedPosition *)toPosition;

    NSRange range = NSMakeRange(MIN(from.index, to.index), ABS(to.index - from.index));

    return [IndexedRange rangeWithNSRange:range];

}

Возврат прямоугольников

Когда пользовательские типы на японском языке, система ввода текста отправляет, когда пузырь исправления появляется и firstRectForRange: и caretRectForPosition: к текстовому представлению. Цель обоих из этих методов состоит в том, чтобы возвратить прямоугольник, включающий или диапазон текста или каре, отмечающее точку вставки. EditableCoreTextView класс реализует первый из этих методов путем вызова метода его встроенного текстового представления, отображающего диапазон на прямоугольник включения (см. Перечисление 10-12). Прежде, чем возвратить прямоугольник, это преобразовывает его в систему локальной координаты.

Перечисление 10-12  реализация firstRectForRange:

- (CGRect)firstRectForRange:(UITextRange *)range {

    IndexedRange *r = (IndexedRange *)range;

    CGRect rect = [_textView firstRectForNSRange:r.range];

    return [self convertRect:rect fromView:_textView];

}

Встроенное текстовое представление в этом случае выполняет львиную долю работы. Используя Базовые текстовые функции, это вычисляет прямоугольник, включающий диапазон текста и возвращающий его, как показано в Перечислении 10-13.

Перечисление 10-13  , Отображающее текст, располагается к включению прямоугольника

- (CGRect)firstRectForNSRange:(NSRange)range; {

    int index = range.location;

    NSArray *lines = (NSArray *) CTFrameGetLines(_frame);

    for (int i = 0; i < [lines count]; i++) {

        CTLineRef line = (CTLineRef) [lines objectAtIndex:i];

        CFRange lineRange = CTLineGetStringRange(line);

        int localIndex = index - lineRange.location;

        if (localIndex >= 0 && localIndex < lineRange.length) {

            int finalIndex = MIN(lineRange.location + lineRange.length,

                range.location + range.length);

            CGFloat xStart = CTLineGetOffsetForStringIndex(line, index, NULL);

            CGFloat xEnd = CTLineGetOffsetForStringIndex(line, finalIndex, NULL);

            CGPoint origin;

            CTFrameGetLineOrigins(_frame, CFRangeMake(i, 0), &origin);

            CGFloat ascent, descent;

            CTLineGetTypographicBounds(line, &ascent, &descent, NULL);

            return CGRectMake(xStart, origin.y - descent, xEnd - xStart, ascent + descent);

        }

    }

    return CGRectNull;

}

Для caretRectForPosition:, подход Вы взятие несколько отличался бы. Сродство выбора (selectionAffinity) фактор для рассмотрения; что еще более важно имейте в виду, что высота и ширина прямоугольника каре могут отличаться от ограничительного прямоугольника, возвращенного из firstRectForRange:.

Тестирование хита

Другая область, где система ввода текста просит, чтобы текстовое представление отобразилось между дисплеем текста и хранением текста, поражена, тестируя. Учитывая точку в текстовом представлении (система ввода текста спрашивает), каковы соответствующая текстовая позиция или текстовый диапазон? UITextInput методы это требует эту информацию, closestPositionToPoint:, closestPositionToPoint:withinRange:, и characterRangeAtPoint:. Перечисление 10-14 иллюстрирует как EditableCoreTextView реализует первый из этих методов.

Перечисление 10-14  реализация closestPositionToPoint:

- (UITextPosition *)closestPositionToPoint:(CGPoint)point {

    NSInteger index = [_textView closestIndexToPoint:point];

    return [IndexedPosition positionWithIndex:(NSUInteger)index];

}

Здесь, как с методами, возвращающими прямоугольники для текстовых диапазонов или текстовых позиций, EditableCoreTextView вызывает метод его встроенного представления, что текст Ядра использования для вычисления индекса символа, соответствующего точке. Перечисление 10-15 иллюстрирует, как встроенное представление выполняет это.

Перечисление 10-15  , Отображающее точку на индекс символа

- (NSInteger)closestIndexToPoint:(CGPoint)point {

    NSArray *lines = (NSArray *) CTFrameGetLines(_frame);

    CGPoint origins[lines.count];

    CTFrameGetLineOrigins(_frame, CFRangeMake(0, lines.count), origins);

    for (int i = 0; i < lines.count; i++) {

        if (point.y > origins[i].y) {

            CTLineRef line = (CTLineRef) [lines objectAtIndex:i];

            return CTLineGetStringIndexForPosition(line, point);

        }

    }

    return  _text.length;

}

Информирование делегата ввода текста изменений

Когда существует изменение в тексте или изменение в выборе, не инициирующемся системой ввода текста, необходимо сообщить делегату ввода текста путем отправки ему надлежащего метода «-изменения». После внесения изменения отправьте делегату соответствующий метод «-изменения».

Делегат ввода текста является предоставленным системой объектом, принимающим UITextInputDelegate протокол. Если класс, принимающий UITextInput протокол определяет inputDelegate свойство, система ввода текста автоматически присваивает объект делегата этому свойству во время выполнения.

Перечисление 10-16 показывает метод действия, вызывающийся, когда пользователь касается в текстовом представлении. Если представление касается, но это не первый респондент, текстовое представление делает себя первым респондентом и запускает сеанс редактирования. Если представление впоследствии касается, текстовое представление отправляет a selectionWillChange: обменивайтесь сообщениями делегату ввода текста. Это тогда очищает любой отмеченный текстовый диапазон и сбрасывает выбранный текстовый диапазон так, чтобы каре было в точке в тексте, где произошел коснувшийся. После этого это вызывает selectionDidChange:.

Перечисление 10-16  , Отправляющее сообщения делегату ввода текста

- (void)tap:(UITapGestureRecognizer *)tap

{

    if (![self isFirstResponder]) {

        _textView.editing = YES;

        [self becomeFirstResponder];

    } else {

        [self.inputDelegate selectionWillChange:self];

        NSInteger index = [_textView closestIndexToPoint:[tap locationInView:_textView]];

        _textView.markedTextRange = NSMakeRange(NSNotFound, 0);

        _textView.selectedTextRange = NSMakeRange(index, 0);

        [self.inputDelegate selectionDidChange:self];

    }

}