Исходная ссылка служб ввода текста

Этот документ описывает Text Input Source Services, интерфейс программирования C в платформе Углерода HIToolbox.

Источники ввода текста попадают в три общих категории:

Источники ввода с клавиатуры, включая раскладки клавиатуры, методы ввода с клавиатуры и режимы ввода
Палитра ввела источники, включая палитру символов, средство просмотра клавиатуры и частные панели словаря
Чернила ввели источники

Палитра ввела источники, и входной источник чернил категоризированы как источники неввода с клавиатуры. Однако входные источники палитры могли бы все еще включить некоторое взаимодействие клавиатуры. Методы ввода с клавиатуры могут быть поддерживающими режим (например, Kotoeri). Следовательно, они - потенциально родитель нескольких режимов ввода, непосредственно можно выбрать в пользовательском интерфейсе (например, hiragana, katakana, и romaji). С поддерживающими режим методами ввода родительский метод ввода не непосредственно можно выбрать. Не включенные методы ввода режима непосредственно можно выбрать.

Некоторые входные источники предоставлены и установлены с OS X. Другие входные источники могут быть установлены как сами сторонние продукты или как часть установки определенных приложений. Международные Предпочтения выводят на экран список всех видимых установленных входных источников. Можно использовать Международные Предпочтения, чтобы включить или отключить больше всего входные источники, предназначающиеся, чтобы быть видимыми в пользовательском интерфейсе. Установите Ассистент, также включает некоторые входные источники. Интерфейс отдельного пользователя обеспечивает способ включить входные источники чернил.

Можно использовать некоторые функции в Text Input Source Services, чтобы включить или отключить входные источники программно в приложении. Один источник ввода с клавиатуры должен быть включен. Только один входной источник чернил может быть включен. Многократные экземпляры других входных исходных типов могут быть включены.

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

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

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

Text Input Source Services указывает современный, не, менеджер по сценарию базировал интерфейсы программирования для работы на источниках ввода текста и выполняет следующие функции:

Находит информацию об источниках ввода текста
Выбирает, включает и отключает источники ввода текста
Получает уведомления о соответствующих изменениях в источниках ввода текста.

Функции

Получение идентификатора типа

TISInputSourceGetTypeID () TISInputSourceGetTypeID

Добирается CFTypeID из исходной ссылки ввода текста.

Объявление

Swift

func TISInputSourceGetTypeID() -> CFTypeID

Objective C

CFTypeID TISInputSourceGetTypeID ( void );

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

CFTypeID из исходной ссылки ввода текста, для сравнения с результатом Базовой Основы CFGetTypeID функция.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

Получение информации об источниках ввода текста


    
    TISGetInputSourceProperty (_: _:)
    TISGetInputSourceProperty

Получает значение указанного свойства для указанного входного источника.

Объявление

Swift

func TISGetInputSourceProperty(_ inputSource: TISInputSource!, _ propertyKey: CFString!) -> UnsafeMutablePointer<Void>

Objective C

void * TISGetInputSourceProperty ( TISInputSourceRef inputSource, CFStringRef propertyKey );

Параметры

`inputSource`	Источник ввода текста, значение свойства которого требуют.
`propertyKey`	Ключ свойства постоянное указание желаемого значения свойства.

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

Тип указателя, подходящий для объекта значения, связался с ключом свойства. Определенный тип указателя указан для каждого ключа. Как правило, это - ссылка типа CF некоторого вида, но в одном случае это - ссылка значка. Функция могла бы возвратиться NULL если указанное свойство отсутствует или недопустимое для указанного входного источника. Вы не должны выпускать объекты, именуемые указателем, если Вы сначала не сохранили их.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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


    
    TISCreateInputSourceList (_: _:)
    TISCreateInputSourceList

Создает список входных источников, то соответствие указало свойства.

Объявление

Swift

func TISCreateInputSourceList(_ properties: CFDictionary!, _ includeAllInstalled: Boolean) -> Unmanaged<CFArray>!

Objective C

CFArrayRef TISCreateInputSourceList ( CFDictionaryRef properties, Boolean includeAllInstalled );

Параметры

`properties`	Словарь ключей свойства и соответствующих значений для фильтрации входного исходного списка. Может быть `NULL`, когда не выполняется никакая фильтрация.
`includeAllInstalled`	Как правило, набор к `false` так, чтобы только включенный входные источники были включены; набор к `true` включать все установленные входные источники, соответствующие фильтр.

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

A CFArrayRef для списка исходных ссылок ввода текста, соответствующих указанные свойства.

Обсуждение

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

Важный

Вызывание этой функции с includeAllInstalled набором параметра к true если параметр свойств, может оказать значительное влияние памяти на вызывающее приложение NULL (соответствуйте все), или если это указывает критерии, которые могли бы соответствовать много установленных входных источников. Эта установка могла бы вызвать кэширование данных для всех входных источников соответствия и привести к выделению до 120K.

Если Вы вызываете TISCreateInputSourceList для нахождения определенного входного источника или источников из числа источников включенными в список сначала вызовите TISCreateInputSourceList с набором includeAllInstalled к false и проверьте, включает ли возвращенный массив желаемый входной источник (и). Если дело обстоит не так, вызвать TISCreateInputSourceList снова с includeAllInstalled набором параметра к true.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

Получение определенных входных источников

TISCopyCurrentKeyboardInputSource () TISCopyCurrentKeyboardInputSource

Копирует исходную ссылку ввода текста для в настоящее время выбираемого источника ввода с клавиатуры.

Объявление

Swift

func TISCopyCurrentKeyboardInputSource() -> Unmanaged<TISInputSource>!

Objective C

TISInputSourceRef TISCopyCurrentKeyboardInputSource ( void );

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

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

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISCopyCurrentKeyboardLayoutInputSource
TISCopyCurrentKeyboardLayoutInputSource () TISCopyCurrentKeyboardLayoutInputSource

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

Объявление

Swift

func TISCopyCurrentKeyboardLayoutInputSource() -> Unmanaged<TISInputSource>!

Objective C

TISInputSourceRef TISCopyCurrentKeyboardLayoutInputSource ( void );

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

Исходная ссылка ввода текста на использующуюся в настоящее время раскладку клавиатуры.

Обсуждение

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

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISCopyCurrentKeyboardInputSource
TISCopyCurrentASCIICapableKeyboardInputSource () TISCopyCurrentASCIICapableKeyboardInputSource

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

Объявление

Swift

func TISCopyCurrentASCIICapableKeyboardInputSource() -> Unmanaged<TISInputSource>!

Objective C

TISInputSourceRef TISCopyCurrentASCIICapableKeyboardInputSource ( void );

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

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

Обсуждение

Если никакой способный к ASCII источник ввода с клавиатуры еще не использовался, функция возвращает способную к ASCII раскладку клавиатуры по умолчанию, выбранную Ассистентом Установки.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISCopyCurrentKeyboardInputSource
TISCopyCurrentASCIICapableKeyboardLayoutInputSource
TISCopyCurrentASCIICapableKeyboardLayoutInputSource () TISCopyCurrentASCIICapableKeyboardLayoutInputSource

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

Объявление

Swift

func TISCopyCurrentASCIICapableKeyboardLayoutInputSource() -> Unmanaged<TISInputSource>!

Objective C

TISInputSourceRef TISCopyCurrentASCIICapableKeyboardLayoutInputSource ( void );

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

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

Обсуждение

Если никакой способный к ASCII источник ввода с клавиатуры не использовался, функция возвращает способную к ASCII раскладку клавиатуры по умолчанию, выбранную Ассистентом Установки.

Если никакое определенное переопределение раскладки клавиатуры не существует, эта функция используется методами ввода использовать раскладку клавиатуры для ключевого перевода. TISCopyCurrentASCIICapableKeyboardInputSource может возвратить входные источники, которые не являются раскладками клавиатуры.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISCopyCurrentASCIICapableKeyboardInputSource


    
    TISCopyInputSourceForLanguage (_:)
    TISCopyInputSourceForLanguage

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

Объявление

Swift

func TISCopyInputSourceForLanguage(_ language: CFString!) -> Unmanaged<TISInputSource>!

Objective C

TISInputSourceRef TISCopyInputSourceForLanguage ( CFStringRef language );

Параметры


      language

A BCP 47 код языка (в той же форме, возвращенной Базовой функцией ОсновыCFLocaleCreateCanonicalLanguageIdentifierFromString function) это представляет язык, для которого должен быть возвращен входной источник.

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

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

Обсуждение

Если текстовое поле, как ожидают, введет на определенном языке, приложение может вызвать TISCopyInputSourceForLanguage и затем TISSelectInputSource выбрать входной источник, подходящий для того языка. Эта функция является заменой для осуждаемой возможности интерфейса программирования KeyScript выбрать входной источник по умолчанию, связанный с определенным кодом сценария.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISSelectInputSource

TISCreateASCIICapableInputSourceList () TISCreateASCIICapableInputSourceList

Создает список способных к ASCII источников ввода с клавиатуры.

Объявление

Swift

func TISCreateASCIICapableInputSourceList() -> Unmanaged<CFArray>!

Objective C

CFArrayRef TISCreateASCIICapableInputSourceList ( void );

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

Список исходных ссылок ввода текста.

Обсуждение

Когда вызов был выполнен, этот список представляет снимок способных к ASCII источников ввода с клавиатуры, включенных. Последовательные вызовы к TISCreateASCIICapableInputSourceList может возвратить различные результаты, потому что, например, промежуточный вызовы пользователь может включить или отключить входной источник в области International Preferences. Когда источник ввода с клавиатуры включен или отключен, пользователем или программно, распределенное уведомление CF kTISNotifyEnabledKeyboardInputSourcesChanged отправляется.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISCopyCurrentASCIICapableKeyboardInputSource

Управление входными источниками

TISSelectInputSource (_:) TISSelectInputSource

Выбирает указанный входной источник.

Объявление

Swift

func TISSelectInputSource(_ inputSource: TISInputSource!) -> OSStatus

Objective C

OSStatus TISSelectInputSource ( TISInputSourceRef inputSource );

Параметры

inputSource

Входной источник Вы желаете выбрать.

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

Код результата. Функциональные возвраты paramErr если входной источник не можно выбрать. Иначе, это возвращается noErr.

Обсуждение

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

Для TISSelectInputSource для следования входной источник должен можно выбрать (т.е. kTISPropertyInputSourceIsSelectCapable установлен в true) и входной источник должен быть включен (т.е. kTISPropertyInputSourceIsEnabled установлен в true). Кроме того, если входной источник является режимом ввода, его родитель должен быть позволен для него быть выбранным.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISDeselectInputSource
TISDeselectInputSource (_:) TISDeselectInputSource

Отменяет выбор указанного входного источника.

Объявление

Swift

func TISDeselectInputSource(_ inputSource: TISInputSource!) -> OSStatus

Objective C

OSStatus TISDeselectInputSource ( TISInputSourceRef inputSource );

Параметры

inputSource

Входной источник Вы хотите отменить выбор.

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

Код результата. Это возвращается paramErr если входной источник не deselectable. Иначе, это возвращается noErr.

Обсуждение

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

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISSelectInputSource
TISEnableInputSource (_:) TISEnableInputSource

Включает указанный входной источник.

Объявление

Swift

func TISEnableInputSource(_ inputSource: TISInputSource!) -> OSStatus

Objective C

OSStatus TISEnableInputSource ( TISInputSourceRef inputSource );

Параметры

inputSource

Входной источник Вы хотите включить.

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

Код результата. Функциональные возвраты paramErr если не может быть включен входной источник. Иначе, это возвращается noErr.

Обсуждение

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

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

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISDisableInputSource
TISDisableInputSource (_:) TISDisableInputSource

Отключает указанный входной источник.

Объявление

Swift

func TISDisableInputSource(_ inputSource: TISInputSource!) -> OSStatus

Objective C

OSStatus TISDisableInputSource ( TISInputSourceRef inputSource );

Параметры

inputSource

Входной источник Вы хотите отключить.

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

Код результата. Функциональные возвраты paramErr если не может быть отключен входной источник. Иначе, это возвращается noErr.

Обсуждение

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

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISEnableInputSource


    
    TISSetInputMethodKeyboardLayoutOverride (_:)
    TISSetInputMethodKeyboardLayoutOverride

Устанавливает переопределение раскладки клавиатуры для метода ввода или режима.

Объявление

Swift

func TISSetInputMethodKeyboardLayoutOverride(_ keyboardLayout: TISInputSource!) -> OSStatus

Objective C

OSStatus TISSetInputMethodKeyboardLayoutOverride ( TISInputSourceRef keyboardLayout );

Параметры


      keyboardLayout

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

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

Код результата. Функциональные возвраты paramErr если keyboardLayout не определяет раскладку клавиатуры, если текущий источник ввода с клавиатуры не является методом ввода или режимом или. Иначе, это возвращается noErr.

Обсуждение

Когда метод ввода или режим являются выбранным входным источником, последний раз используемая способная к ASCII раскладка клавиатуры для перевода ключевых событий используется. Эта раскладка клавиатуры является также той, появляющейся в Средстве просмотра Клавиатуры. Входной источник для этой раскладки клавиатуры возвращается функциейTISCopyCurrentASCIICapableKeyboardLayoutInputSource. Если различная раскладка клавиатуры должна использоваться для определенного метода ввода или режима, активированный метод ввода или режим должны вызвать TISSetInputMethodKeyboardLayoutOverride указать желаемую раскладку клавиатуры.

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

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

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

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

Поведение по умолчанию является новым с OS X v10.5 и устраняет необходимость, чтобы методы ввода имели пользовательский интерфейс для установки ASCII - способная клавиатура для фонетического ввода на основе латинских символов.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISCopyInputMethodKeyboardLayoutOverride

TISCopyInputMethodKeyboardLayoutOverride () TISCopyInputMethodKeyboardLayoutOverride

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

Объявление

Swift

func TISCopyInputMethodKeyboardLayoutOverride() -> Unmanaged<TISInputSource>!

Objective C

TISInputSourceRef TISCopyInputMethodKeyboardLayoutOverride ( void );

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

Если текущий источник ввода с клавиатуры является методом ввода или режимом, имеющим переопределение раскладки клавиатуры, исходная ссылка ввода текста для той раскладки клавиатуры возвращается. Иначе, функциональные возвраты NULL.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

См. также

TISSetInputMethodKeyboardLayoutOverride

Регистрация входного источника

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

Объявление

Swift

func TISRegisterInputSource(_ location: CFURL!) -> OSStatus

Objective C

OSStatus TISRegisterInputSource ( CFURLRef location );

Параметры

location

Расположение входных источников в файле или пакете.

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

Код результата. Функциональные возвраты paramErr если расположение недопустимо, или входные источники в указанном расположении не могут быть зарегистрированы. Иначе, это возвращается noErr.
Обсуждение

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

Можно только использовать эту функцию для регистрации следующего:
- Файлы раскладки клавиатуры или пакеты в /Library/Keyboard Layouts/ или ~/Library/Keyboard Layouts/ каталог (доступный всем пользователям или текущему пользователю, соответственно). Такие раскладки клавиатуры, когда-то включенные, можно выбрать.
- Метод ввода связывается в новом Library/Input Methods/ или ~/Library/Input Methods/ каталоги (доступный всем пользователям или текущему пользователю, соответственно).
Примечание:

Пакеты метода ввода могут включать частные невыбираемые раскладки клавиатуры для использования с TISSetInputMethodKeyboardLayoutOverride. Они регистрируются автоматически, когда метод ввода регистрируется, и не должны быть отдельно зарегистрированы. Они не регистрируются с помощью TISRegisterInputSource.

Безопасность: Любой вызывающий код TISRegisterInputSource часть приложения или службы, уже проверенной в некотором роде (например, пользователем).
Оператор импорта

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

Типы данных

TISInputSourceRef TISInputSourceRef

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

Объявление

Swift

typealias TISInputSourceRef = TISInputSource

Objective C

typedef struct __TISInputSource* TISInputSourceRef;

Обсуждение

Исходная ссылка ввода текста не может быть совместно использована через процессы.

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

Objective C

@import Carbon;

Swift

import Carbon

Доступность

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

Константы

Ключевые константы свойства
CF представляет в виде строки говорящие ссылки TISGetInputSourceProperty какое свойство для возврата; возвращенные свойства являются различными указанными типами, такими как CFBooleanRef, CFArrayRef, и т.д. (Также используемый с TISCreateInputSourceList.

Объявление

Objective C

const CFStringRef kTISPropertyInputSourceCategory const CFStringRef kTISPropertyInputSourceType const CFStringRef kTISPropertyInputSourceIsASCIICapable const CFStringRef kTISPropertyInputSourceIsEnableCapable const CFStringRef kTISPropertyInputSourceIsSelectCapable const CFStringRef kTISPropertyInputSourceIsEnabled const CFStringRef kTISPropertyInputSourceIsSelected const CFStringRef kTISPropertyInputSourceID const CFStringRef kTISPropertyBundleID const CFStringRef kTISPropertyInputModeID const CFStringRef kTISPropertyLocalizedName const CFStringRef kTISPropertyInputSourceLanguages const CFStringRef kTISPropertyUnicodeKeyLayoutData const CFStringRef kTISPropertyIconRef const CFStringRef kTISPropertyIconImageURL

Константы
- kTISPropertyInputSourceCategory
  
  kTISPropertyInputSourceCategory
  
  Этот ключ свойства определяет значение свойства, которое является a CFStringRef указание категории входного источника.
  
  Возможные значения указаны следующими константами значения свойства: kTISCategoryKeyboardInputSource, kTISCategoryPaletteInputSource, и kTISCategoryInkInputSource.
- kTISPropertyInputSourceType
  
  kTISPropertyInputSourceType
  
  Этот ключ свойства определяет значение свойства, которое является a CFStringRef указание определенного типа входного источника.
  
  Возможные значения указаны следующими константами значения свойства: kTISTypeKeyboardLayout, kTISTypeKeyboardInputMethodWithoutModes, kTISTypeKeyboardInputMethodModeEnabled, kTISTypeKeyboardInputMode, kTISTypeCharacterPalette, kTISTypeKeyboardViewer, и kTISTypeInk.
- kTISPropertyInputSourceIsASCIICapable
  
  kTISPropertyInputSourceIsASCIICapable
  
  Этот ключ свойства определяет значение свойства, которое является a CFBooleanRef указание, предназначается ли входной источник, чтобы быть способным к вводу ASCII.
- kTISPropertyInputSourceIsEnableCapable
  
  kTISPropertyInputSourceIsEnableCapable
  
  Этот ключ свойства определяет значение свойства, которое является a CFBooleanRef указание, можно ли с помощью входной источник когда-либо программно включать TISEnableInputSource.
  
  Можно включить больше всего входные источники программно в любое время. kTISPropertyInputSourceIsEnableCapable установлен в true для этих входных источников.
  
  Некоторые входные источники никогда не могут программно включаться. Это в основном метод ввода частные раскладки клавиатуры, используемые методом ввода через функциюTISSetInputMethodKeyboardLayoutOverride. Вы не можете непосредственно включить эти разметки, ни использовать их в качестве входных источников раскладки клавиатуры. kTISPropertyInputSourceIsEnableCapable установлен в false для них.
  
  Некоторые входные источники могут быть программно включены только при корректных условиях. Это в основном режимы ввода, которые могут быть изменены от отключенного до включенного, только если включен их родительский метод ввода. Если их родительский метод ввода отключен, Однако они могут уже быть во включенном состоянии, но не в настоящее время можно выбрать. kTISPropertyInputSourceIsEnableCapable true для них.
- kTISPropertyInputSourceIsSelectCapable
  
  kTISPropertyInputSourceIsSelectCapable
  
  Этот ключ свойства определяет значение свойства, которое является a CFBooleanRef указание, может ли входной источник когда-либо программно выбираться с помощью TISSelectInputSource.
  
  Это статическое свойство входного источника не зависит ни от какого текущего состояния. Для входных источников, которые могут быть программно выбраны, если им включают, kTISPropertyInputSourceIsSelectCapable установлен в true.
  
  Для входных источников, которые никогда не могут программно выбираться, даже если им включают, kTISPropertyInputSourceIsSelectCapable установлен в false. Такие источники являются в основном методами ввода, имеющими режимы (родительские методы ввода); только их режимы могут быть выбраны.
  
  Для входных источников, которые включены и могут только быть программно выбраны при корректных условиях, kTISPropertyInputSourceIsSelectCapable установлен в true. Такие входные источники являются в основном режимами ввода, которые могут только быть выбраны, если и им и их родительскому методу ввода включают.
  
  Для входных источников, которые никогда не могут включаться или выбираться, kTISPropertyInputSourceIsSelectCapable установлен в false.
- kTISPropertyInputSourceIsEnabled
  
  kTISPropertyInputSourceIsEnabled
  
  Этот ключ свойства определяет значение свойства, которое является a CFBooleanRef указание, включается ли в настоящее время входной источник.
- kTISPropertyInputSourceIsSelected
  
  kTISPropertyInputSourceIsSelected
  
  Этот ключ свойства определяет значение свойства, которое является a CFBooleanRef указание, выбирается ли в настоящее время входной источник.
- kTISPropertyInputSourceID
  
  kTISPropertyInputSourceID
  Этот ключ свойства определяет значение свойства, которое является a CFStringRef для уникального обратного имени DNS, связанного с входным источником.
  
  Для методов ввода с клавиатуры и для палитры или чернил вводит источники, обычно, пакет ID, например, com.apple.Kotoeri.
  
  Для режимов ввода с клавиатуры, обычно, пакет ID родительского метода ввода плюс суффикс, однозначно определяющий режим ввода, например, com.apple.Kotoeri.Katakana. Это не универсальное имя режима ввода, используемое через методы ввода, например, com.apple.inputmethod.Japanese.Katakana.
  
  Для раскладок клавиатуры, новый идентификационный механизм, обычно структурированный как com.company.keyboardlayout.name,например, com.apple.keyboardlayout.US.
- kTISPropertyBundleID
  
  kTISPropertyBundleID
  
  Этот ключ свойства определяет значение свойства, которое является a CFStringRef для обратного DNS BundleID, связанного с входным источником.
- kTISPropertyInputModeID
  
  kTISPropertyInputModeID
  
  Этот ключ свойства определяет значение свойства, которое является a CFStringRef для обратной строки DNS, идентифицирующей определенный класс использования для режимов ввода.
  
  Например, com.apple.inputmethod.Japanese.Katakana идентифицирует стандартный Katakana-входной класс использования, который может быть связан с режимами ввода от нескольких различных методов ввода.
  
  Можно присоединить этот режим ввода к a TSMDocument использование TSMSetDocumentProperty функция с тегом kTSMDocumentInputModePropertyTag, управлять классом использования режима ввода, который должен использоваться с этим документ TSM.
- kTISPropertyLocalizedName
  
  kTISPropertyLocalizedName
  
  Этот ключ свойства определяет значение свойства, которое является a CFStringRef для локализованного имени источника ввода, как предназначено для использования пользовательского интерфейса.
  
  Использует лучшее соответствие (определенный CFBundle) между локализацией, используемой вызывающей стороной и доступными локализациями входного исходного имени. В некоторых случаях это могло бы быть нелокализованным именем.
- kTISPropertyInputSourceLanguages
  
  kTISPropertyInputSourceLanguages
  
  Этот ключ свойства определяет значение свойства, которое является a CFArrayRef для массива CFStringRefs, где каждая строка является кодом языка для языка, который может быть введен с помощью входного источника. Можно использовать эту константу с TISGetInputSourceProperty функция, но Вы не можете использовать его в словаре фильтра, переданном TISCreateInputSourceList функция.
  
  Коды языков находятся в том же BCP 47 форма, возвращенная CFLocaleCreateCanonicalLanguageIdentifierFromString функция. Первый код языка в массиве является языком, для которого предназначается входной источник. Если никакой такой язык не существует (например, для Шестнадцатеричной Входной раскладки клавиатуры Unicode), первый код языка является пустой строкой.
- kTISPropertyUnicodeKeyLayoutData
  
  kTISPropertyUnicodeKeyLayoutData
  
  Этот ключ свойства определяет значение свойства, которое является a CFDataRef это относится к 'uchr' данные раскладки клавиатуры для раскладки клавиатуры вводят источник.
  
  'uchr' данные находятся в порядке собственного порядка байтов. Если входной источник не является раскладкой клавиатуры или является раскладкой клавиатуры для который только 'KCHR data' доступно, значение NULL.
  
  Примечание:
  
  Вы не можете использовать этот ключ (и его соответствующее значение) используемый в словаре фильтра передал TISCreateInputSourceList функция.
- kTISPropertyIconRef
  
  kTISPropertyIconRef
  
  Этот ключ свойства определяет значение свойства, которое является IconRef значение для входного исходного значка.
  
  Ссылки значка являются типичным форматом значка для раскладок клавиатуры и методов ввода. Если ссылка значка не доступна для указанного входного источника, значение NULL.
  
  Примечание:
  
  Вы не можете использовать этот ключ (и его соответствующее значение) используемый в словаре фильтра передал TISCreateInputSourceList функция.
- kTISPropertyIconImageURL
  
  kTISPropertyIconImageURL
  
  Этот ключ свойства определяет значение свойства, которое является a CFURLRef указание файла, содержащего изображение (обычно TIFF), чтобы использоваться в качестве входного исходного значка.
  
  Если файл образа, URL не доступен для указанного входного источника, значение, NULL. Обратите внимание на то, что другие форматы изображения (например, JPEG, PNG) могут также использоваться в будущем.
  
  Примечание:
  
  Вы не можете использовать этот ключ (и его соответствующее значение) используемый в словаре фильтра передал TISCreateInputSourceList функция.
Обсуждение

Входные источники могут иметь дополнительные свойства, и некоторые входные источники не имеют значений для некоторых свойств описанными в этом разделе. Для получения значения свойства для определенного входного источника используйте TISGetInputSourceProperty функция. Для использования ряда определенных пар ключ/значение свойства в качестве фильтра при создании списка входных источников вызовите TISCreateInputSourceList функция.

Доступность

Доступный в OS X v10.5 и позже.
Входные исходные значения свойств категории
Опишите входные исходные категории, связанные с различными ключами свойства.

Объявление

Objective C

const CFStringRef kTISCategoryKeyboardInputSource const CFStringRef kTISCategoryPaletteInputSource const CFStringRef kTISCategoryInkInputSource

Константы
- kTISCategoryKeyboardInputSource
  
  kTISCategoryKeyboardInputSource
  
  Одно входное исходное значение категории связалось с ключом свойства kTISPropertyInputSourceCategory.
  
  Эта категория включает раскладки клавиатуры, методы ввода с клавиатуры (и с режимами и без) и режимами ввода с клавиатуры. По крайней мере один входной источник в этой категории установлен. Из всех входных источников в этой категории точно каждый выбран; выбор нового отменяет выбор предыдущего.
- kTISCategoryPaletteInputSource
  
  kTISCategoryPaletteInputSource
  
  Одно входное исходное значение категории связалось с ключом свойства kTISPropertyInputSourceCategory.
  
  Эта категория включает средства просмотра клавиатуры и палитры символов. Можно выбрать 0 или больше категорий.
- kTISCategoryInkInputSource
  
  kTISCategoryInkInputSource
  
  Одно входное исходное значение категории связалось с ключом свойства kTISPropertyInputSourceCategory.
  
  Можно установить или выбрать 0 или 1 чернила ввели источник.
Доступность

Доступный в OS X v10.5 и позже.
Входные исходные значения свойств типа
Входные исходные значения типа связались с различными ключами свойства.

Объявление

Objective C

const CFStringRef kTISTypeKeyboardLayout const CFStringRef kTISTypeKeyboardInputMethodWithoutModes const CFStringRef kTISTypeKeyboardInputMethodModeEnabled const CFStringRef kTISTypeKeyboardInputMode const CFStringRef kTISTypeCharacterPalette const CFStringRef kTISTypeKeyboardViewer const CFStringRef kTISTypeInk

Константы
- kTISTypeKeyboardLayout
  
  kTISTypeKeyboardLayout
  
  Одно входное исходное значение типа связалось с ключом свойства kTISPropertyInputSourceType.
  
  Этот тип принадлежит категории kTISCategoryKeyboardInputSource.
- kTISTypeKeyboardInputMethodWithoutModes
  
  kTISTypeKeyboardInputMethodWithoutModes
  
  Одно входное исходное значение типа связалось с ключом свойства kTISPropertyInputSourceType.
  
  Этот тип принадлежит категории kTISCategoryKeyboardInputSource.
- kTISTypeKeyboardInputMethodModeEnabled
  
  kTISTypeKeyboardInputMethodModeEnabled
  
  Одно входное исходное значение типа связалось с ключом свойства kTISPropertyInputSourceType.
  
  Этот тип принадлежит категории kTISCategoryKeyboardInputSource.
- kTISTypeKeyboardInputMode
  
  kTISTypeKeyboardInputMode
  
  Одно входное исходное значение типа связалось с ключом свойства kTISPropertyInputSourceType.
  
  Этот тип принадлежит категории kTISCategoryKeyboardInputSource.
- kTISTypeCharacterPalette
  
  kTISTypeCharacterPalette
  
  Одно входное исходное значение типа связалось с ключом свойства kTISPropertyInputSourceType.
  
  Этот тип принадлежит категории kTISCategoryPaletteInputSource.
- kTISTypeKeyboardViewer
  
  kTISTypeKeyboardViewer
  
  Одно входное исходное значение типа связалось с ключом свойства kTISPropertyInputSourceType.
  
  Этот тип принадлежит категории kTISCategoryPaletteInputSource.
- kTISTypeInk
  
  kTISTypeInk
  
  Одно входное исходное значение типа связалось с ключом свойства kTISPropertyInputSourceType.
  
  Этот тип принадлежит категории kTISCategoryInkInputSource. Даже при том, что это - единственный тип в той категории, тип предоставлен так, чтобы клиенты, которым не нужна информация о категории, могли просто проверить входной исходный тип.
Доступность

Доступный в OS X v10.5 и позже.
Уведомления
CF распределил уведомления для изменений для ввода источников.

Объявление

Objective C

const CFStringRef kTISNotifySelectedKeyboardInputSourceChanged const CFStringRef kTISNotifyEnabledKeyboardInputSourcesChanged

Константы
- kTISNotifySelectedKeyboardInputSourceChanged
  
  kTISNotifySelectedKeyboardInputSourceChanged
  
  Имя CF распределило уведомление для разнообразия выбранному источнику ввода с клавиатуры.
- kTISNotifyEnabledKeyboardInputSourcesChanged
  
  kTISNotifyEnabledKeyboardInputSourcesChanged
  
  Имя CF распределило уведомление для разнообразия набору включенных источников ввода с клавиатуры.
Доступность

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