NSTextInput

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

NSTextView и его абстрактный суперкласс NSText единственные классы, включенные в Какао та реализация NSTextInput. Для создания другого текста просматривают класс, можно или разделить на подклассы NSTextView (и нет NSText, по историческим причинам), или подкласс NSView и реализация NSTextInput протокол.

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

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

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.

Отмеченный текст

hasMarkedText - hasMarkedText (OS X v10.6)

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

Объявление

Objective C

- (BOOL)hasMarkedText

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

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

Обсуждение

В отличие от других методов в этом протоколе, этого не вызывает входной сервер. Само текстовое представление может вызвать этот метод, чтобы определить, существует ли в настоящее время отмеченный текст. NSTextView, например, когда этот метод возвращается, отключает пункт меню Edit> Copy YEStrue.

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

См. также

– markedRange
markedRange - markedRange (OS X v10.6)

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

Объявление

Objective C

- (NSRange)markedRange

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

Диапазон отмеченного текста.

Обсуждение

Возвращенный диапазон измеряется от запуска текстового хранения получателя. Возвращаемое значение location NSNotFound, и length 0 если и только если hasMarkedText возвраты NOfalse.

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

См. также

– setMarkedText:selectedRange:
– unmarkText
– hasMarkedText
selectedRange - selectedRange (OS X v10.6)

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

Объявление

Objective C

- (NSRange)selectedRange

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

Диапазон выделенного текста.

Обсуждение

Возвращенный диапазон измеряется от запуска текстового хранения получателя. Если нет никакого выбора, возвращаемое значение location NSNotFound, и length 0.

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

См. также

– setMarkedText:selectedRange:


    
    setMarkedText:selectedRange:
    - setMarkedText:selectedRange:

(OS X v10.6)

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

Объявление

Objective C

- (void)setMarkedText:(id)aString selectedRange:(NSRange)selRange

Параметры

`aString`	Любой `NSString` или `NSAttributedString` объект; не должен быть `nil`.
`selRange`	Диапазон в `aString` установить как выбор.

Обсуждение

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

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.6.

См. также

– selectedRange
– unmarkText

unmarkText - unmarkText (OS X v10.6)

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

Объявление

Objective C

- (void)unmarkText

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

См. также

– selectedRange
– setMarkedText:selectedRange:
validAttributesForMarkedText - validAttributesForMarkedText (OS X v10.6)

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

Объявление

Objective C

- (NSArray *)validAttributesForMarkedText

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

Массив NSString объекты, представляющие имена для поддерживаемых атрибутов.

Обсуждение

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

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

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


    
    attributedSubstringFromRange:
    - attributedSubstringFromRange:

(OS X v10.6)

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

Объявление

Objective C

- (NSAttributedString *)attributedSubstringFromRange:(NSRange)theRange

Параметры


      theRange

Диапазон в текстовом хранении, из которого можно создать возвращаемую строку.

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

Строка создается из данного диапазона.

Обсуждение

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

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

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.

Осуждаемый в OS X v10.6.

insertText: - insertText: (OS X v10.6)

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

Объявление

Objective C

- (void)insertText:(id)aString

Параметры

aString

Любой NSString или NSAttributedString объект.

Обсуждение

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

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

Символьные координаты

characterIndexForPoint: - characterIndexForPoint: (OS X v10.6)

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

Объявление

Objective C

- (NSUInteger)characterIndexForPoint:(NSPoint)thePoint

Параметры

thePoint

Точка, в координатах экрана.

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

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

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.
firstRectForCharacterRange: - firstRectForCharacterRange: (OS X v10.6)

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

Объявление

Objective C

- (NSRect)firstRectForCharacterRange:(NSRange)theRange

Параметры

theRange

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

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

Прямоугольник кадра для данного диапазона символов.

Обсуждение

Если theRange промежутки многократные строки текста в текстовом представлении, прямоугольник возвратился, тот для символов в первой строке. Если длина theRange 0 (как это было бы, если нет ничего выбранного в точке вставки), прямоугольник совпадает с точкой вставки, и ее ширина 0.

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

Привязки клавиш

doCommandBySelector: - doCommandBySelector: (OS X v10.6)

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

Объявление

Objective C

- (void)doCommandBySelector:(SEL)aSelector

Параметры

aSelector

Селектор, который будет вызван.

Обсуждение

Если aSelector не может быть вызван, тогда doCommandBySelector: не должен передавать это сообщение цепочка респондента. NSResponder также реализуют этот метод, и он действительно направляет uninvokable команды цепочка респондента, но текстовое представление не должно. Текстовое представление, реализовывая протокол NSTextInput наследовалось от NSView, который наследовался от NSResponder, таким образом, Ваша реализация этого метода переопределит тот в NSResponder. Это не должно вызывать super.

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

См. также

– interpretKeyEvents: (NSResponder)
– doCommandBySelector: (NSResponder)

Прочее.

conversationIdentifier - conversationIdentifier (OS X v10.6)

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

Объявление

Objective C

- (NSInteger)conversationIdentifier

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

Число идентификации получателя.

Обсуждение

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

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.