IMKInputController

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

IMKInputController возразите вводу текста средств управления на стороне метода ввода. Это управляет событиями и текстом из приложений и преобразованного текста от механизма метода ввода. IMKInputController реализации полностью IMKStateSetting и IMKMouseHandling протоколы. Обычно Вы не должны переопределять этот класс, но действительно необходимо обеспечить, делегат возражают, что реализует методы, Ваш интересующиеся. IMKInputController версии методов протокола проверяют, реализует ли объект делегата метод и вызывает версию делегата, если это существует.

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

NSObject
IMKInputController

NSObject
IMKInputController

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

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

Swift

import InputMethodKit

Objective C

@import InputMethodKit;

Доступность

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

Инициализация входного контроллера


    
    init (server:delegate:client:)
    - initWithServer:delegate:client:

Инициализирует элемент управления вводом путем установки делегата.

Объявление

Swift

init!(server server: IMKServer!, delegate delegate: AnyObject!, client inputClient: AnyObject!)

Objective C

- (id)initWithServer:(IMKServer *)server delegate:(id)delegate client:(id)inputClient

Параметры

`server`	Серверный объект для контроллера.
`delegate`	Объект делегата.
`inputClient`	Объект клиента, который отправит сообщения в контроллер с помощью серверный объекта. Объект клиента должен подтвердить к `IMKTextInput` протокол.

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

Инициализированный объект входного контроллера.

Обсуждение

Методы в IMKStateSetting и IMKMouseHandling протоколы, реализованные объектом делегата всегда, включают клиентский параметр. Методы в IMKInputController класс не должен брать клиент потому что initWithServer:delegate:client: метод хранит объект клиента, который Вы предоставляете как ivar, когда это инициализирует IMKInputController объект.

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

Работа с диапазонами

compositionAttributesAtRange (_:) - compositionAttributesAtRange:

Возвращает словарь текстовых атрибутов.

Объявление

Swift

func compositionAttributesAtRange(_ range: NSRange) -> NSMutableDictionary!

Objective C

- (NSMutableDictionary *)compositionAttributesAtRange:(NSRange)range

Параметры

range

Диапазон текста, атрибуты которого Вы хотите получить.

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

Словарь текстовых атрибутов. Реализация по умолчанию возвращает пустой словарь.

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

Доступный в OS X v10.5 и позже.
selectionRange () - selectionRange

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

Объявление

Swift

func selectionRange() -> NSRange

Objective C

- (NSRange)selectionRange

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

Диапазон выбора.

Обсуждение

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

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

Доступный в OS X v10.5 и позже.
replacementRange () - replacementRange

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

Объявление

Swift

func replacementRange() -> NSRange

Objective C

- (NSRange)replacementRange

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

Диапазон для замены.

Обсуждение

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

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

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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


    
    markForStyle (_: atRange:)
    - markForStyle:atRange:

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

Объявление

Swift

func markForStyle(_ style: Int, atRange range: NSRange) -> [NSObject : AnyObject]!

Objective C

- (NSDictionary *)markForStyle:(NSInteger)style atRange:(NSRange)range

Параметры

`style`	Стиль, который должен быть одним из следующих значений: `kTSMHiliteSelectedRawText`, `kTSMHiliteConvertedText`, или `kTSMHiliteSelectedConvertedText`. Посмотрите `AERegistry.h` заголовочный файл для определения этих значений.
`range`	Диапазон (т.е. пункт) для маркировки.

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

Словарь текстовых атрибутов.

Обсуждение

Эта служебная функция может быть вызвана методами ввода отметить каждый диапазон (т.е. пункт) отмеченного текста. T

Реализация по умолчанию сначала вызывает метод compositionAttributesAtRange: получить дополнительные атрибуты, которые метод ввода хочет включать, такие как информация о глифе или шрифт. Затем это добавляет надлежащую информацию о цвете подчеркивания и цвете подчеркивания к словарю атрибутов для параметра стиля. Наконец это добавляет значение стиля как значение словаря. Ключ для значения стиля NSMarkedClauseSegmentAttributeName.

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

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

делегат; - делегат;

Возвращает делегата к объекту входного контроллера.

Объявление

Objective C

- (id)delegate

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

Объект делегата.

См. также

– setDelegate:
setDelegate (_:) - setDelegate:

Устанавливает делегата к объекту входного контроллера.

Объявление

Swift

func setDelegate(_ newDelegate: AnyObject!)

Objective C

- (void)setDelegate:(id)newDelegate

Параметры

newDelegate

Объект делегата установить.

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

См. также

– делегат;

Получение объектов клиента и сервера

сервер () - сервер

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

Объявление

Swift

func server() -> IMKServer!

Objective C

- (IMKServer *)server

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

Серверный объект.

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

Доступный в OS X v10.5 и позже.
клиент () - клиент

Возвращает объект клиента, связанный с входным контроллером.

Объявление

Swift

func client() -> protocol<IMKTextInput, NSObjectProtocol>!

Objective C

- (id<IMKTextInput,NSObject>)client

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

Объект клиента.

Обсуждение

Объект клиента соответствует IMKTextInput протокол.

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

Отслеживание выборов


    
    annotationSelected (_: forCandidate:)
    - annotationSelected:forCandidate:

Отправляет выбранную строку кандидата и строку аннотации к входному контроллеру.

Объявление

Swift

func annotationSelected(_ annotationString: NSAttributedString!, forCandidate candidateString: NSAttributedString!)

Objective C

- (void)annotationSelected:(NSAttributedString *)annotationString forCandidate:(NSAttributedString *)candidateString

Параметры

`annotationString`	Строка аннотации связалась с кандидатом.
`candidateString`	Строка кандидата, в которую переместился пользователь.

Обсуждение

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

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

candidateSelectionChanged (_:) - candidateSelectionChanged:

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

Объявление

Swift

func candidateSelectionChanged(_ candidateString: NSAttributedString!)

Objective C

- (void)candidateSelectionChanged:(NSAttributedString *)candidateString

Параметры

candidateString

Измененная строка кандидата.

Обсуждение

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

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

См. также

– candidateSelected:
candidateSelected (_:) - candidateSelected:

Сообщает входному контроллеру, что выбран новый кандидат.

Объявление

Swift

func candidateSelected(_ candidateString: NSAttributedString!)

Objective C

- (void)candidateSelected:(NSAttributedString *)candidateString

Параметры

candidateString

Измененная строка кандидата.

Обсуждение

Объект кандидата является заключительным выбором пользователя из окна кандидата. Окно кандидата закрывается, прежде чем этот метод вызывают.

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

См. также

– candidateSelectionChanged:

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

updateComposition () - updateComposition

Сообщает входному контроллеру, что изменился состав.

Объявление

Swift

func updateComposition()

Objective C

- (void)updateComposition

Обсуждение

Это вызовы метода метод протокола composedString: получить текущий состав. Текущий состав отправляется клиенту вызовом к методу setMarkedText:selectionRange:replacementRange:.

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

Доступный в OS X v10.5 и позже.
cancelComposition () - cancelComposition

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

Объявление

Swift

func cancelComposition()

Objective C

- (void)cancelComposition

Обсуждение

Это вызовы метода метод originalString: получить оригинальный текст и отправляет тот текст клиенту, использующему вызов для IMKTextInput метод протокола insertText:replacementRange:

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

Сокрытие пользовательского интерфейса

hidePalettes () - hidePalettes

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

Объявление

Swift

func hidePalettes()

Objective C

- (void)hidePalettes

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

Работа с пользовательскими командами


    
    doCommandBySelector (_: commandDictionary:)
    - doCommandBySelector:commandDictionary:

Команды передач, не сгенерированные как часть процесса ввода текста.

Объявление

Swift

func doCommandBySelector(_ aSelector: Selector, commandDictionary infoDictionary: [NSObject : AnyObject]!)

Objective C

- (void)doCommandBySelector:(SEL)aSelector commandDictionary:(NSDictionary *)infoDictionary

Параметры

`aSelector`	Селектор, представляющий команду из меню ввода текста.
`infoDictionary`	Словарь, содержащий две пары ключ/значение: `kIMKCommandMenuItemName`, чье значение `NSMenuItem` объект. Т.е. элемент выбран пользователем. `kIMKCommandClientName`, чье значение является текущим клиентом —`id<IMKTextInput, NSObject>`.

Обсуждение

Реализация по умолчанию проверяет, реагирует ли объект входного контроллера (т.е. сам) на селектор. Если так, это отправляет сообщение performSelector:withObject: к классу входного контроллера. Параметр объекта в этом случае infoDictionary параметр.

Когда пользователь выбирает команду из меню ввода текста, этот метод вызывают. Для поддержки этого метод ввода должен обеспечить действия для каждого пункта меню, помещающегося в меню. Например, (void)menuAction:(id)sender. Обратите внимание на то, что отправитель в этом экземпляре является информационным словарем.

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

См. также

– меню

меню () - меню

Возвращает меню команд, которые являются определенными для метода ввода.

Объявление

Swift

func menu() -> NSMenu!

Objective C

- (NSMenu *)menu

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

Объект меню.

Обсуждение

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

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

Objective C

@import InputMethodKit;

Swift

import InputMethodKit

Доступность

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

См. также

– doCommandBySelector:commandDictionary: