| Пакет | flash.system |
| Класс | public final class IME |
| Наследование | IME  EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Поддержка в профилях AIR: эта функция поддерживается в компьютерных операционных системах, но не на всех мобильных устройствах. Она также не поддерживается на устройствах AIR for TV. Используйте свойство IME.isSupported, чтобы проверить наличие поддержки в cреде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».
Редакторы IME позволяют пользователям вводить тексты с символами, отличными от ASCII, используя многобайтовые языки, такие как китайский, японский и корейский. Дополнительные сведения о работе с редактором IME см. в документации по операционной системе, для которой разрабатывается приложение. Дополнительные ресурсы доступны на следующих web-сайтах:
- http://www.microsoft.com/globaldev/default.mspx
- http://developer.apple.com/documentation/
- http://java.sun.com
Если редактор IME не активен на компьютере пользователя, то обращения к методам или свойствам IME, отличным от Capabilities.hasIME, будут завершаться ошибками. Как только редактор IME будет активирован вручную, последующие обращения ActionScript к методам и свойствам IME будут срабатывать ожидаемым образом. Например, если используется японский редактор IME, он должен быть активирован до того, как вызывается любой метод или свойство IME.
В следующей таблице показаны платформы, поддерживаемые данным классом:
| Возможность | Windows | Mac OSX | Linux |
|---|---|---|---|
Определяет, установлен ли редактор IME: Capabilities.hasIME
| Да | Да | Да |
Переключает редактор IME в активное или неактивное состояние: IME.enabled
| Да | Да | Да |
Определяет, активен ли редактор IME или нет: IME.enabled
| Да | Да | Да |
Получает или устанавливает режим преобразования IME: IME.conversionMode
| Да | Да ** | Нет |
Посылает редактору IME строку для преобразования: IME.setCompositionString()
| Да * | Нет | Нет |
Получает из редактора IME исходную строку до преобразования: System.ime.addEventListener()
| Да * | Нет | Нет |
Отправляет запрос на преобразование в редактор IME: IME.doConversion()
| Да * | Нет | Нет |
* Не все редакторы IME в Windows поддерживают эти операции в полном объеме. Единственный редактор IME, который поддерживает их все, это японский редактор IME.
** На платформе Macintosh только японский редактор IME поддерживает эти методы, а редакторы IME независимых поставщиков не поддерживают их.
Версия этого класса в ActionScript 3.0 не поддерживает Macintosh Classic.
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| conversionMode : String [статические]
Режим преобразования текущего IME. | IME | ||
| enabled : Boolean [статические]
Указывает, включен ли системный редактор IME (значение true) или выключен (значение false). | IME | ||
| isSupported : Boolean [статические] [только для чтения]
Свойству isSupported задается значение true, если текущая платформа поддерживает класс IME, в противном случае задается значение false. | IME | ||
| Метод | Определено | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
[статические]
Заставляет среду выполнения прерывать выполняемую компоновку. | IME | ||
[статические]
Этот метод следует вызывать, когда выделенная область в пределах компоновки обновляется в результате взаимодействия пользователя или выполнения кода программы. | IME | ||
|
Посылает событие в поток событий. | EventDispatcher | |
[статические]
Предписывает IME выбрать первого кандидата для текущей строки композиции. | IME | ||
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
[статические]
Задает строку композиции IME. | IME | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется, когда пользователь завершил работу в редакторе методов ввода (IME), и доступна строка чтения. | IME | |||
conversionMode | свойство |
conversionMode:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Режим преобразования текущего IME. Возможными значениями являются строковые константы режима IME, указывающие режим преобразования:
ALPHANUMERIC_FULLALPHANUMERIC_HALFCHINESEJAPANESE_HIRAGANAJAPANESE_KATAKANA_FULLJAPANESE_KATAKANA_HALFKOREANUNKNOWN(значение доступно только для чтения; не может быть установлено вручную)
Реализация
public static function get conversionMode():String public static function set conversionMode(value:String):voidВыдает
Error — Попытка установки завершилась неудачно.
|
Связанные элементы API
flash.system.IMEConversionMode.ALPHANUMERIC_HALF
flash.system.IMEConversionMode.CHINESE
flash.system.IMEConversionMode.JAPANESE_HIRAGANA
flash.system.IMEConversionMode.JAPANESE_KATAKANA_FULL
flash.system.IMEConversionMode.JAPANESE_KATAKANA_HALF
flash.system.IMEConversionMode.KOREAN
flash.system.IMEConversionMode.UNKNOWN
enabled | свойство |
enabled:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает, включен ли системный редактор IME (значение true) или выключен (значение false). Если редактор IME включен, можно выполнять ввод в многобайтовой кодировке; а если выключен — только буквенно-символьный ввод.
Реализация
public static function get enabled():Boolean public static function set enabled(value:Boolean):voidВыдает
Error — Попытка установки завершилась неудачно.
|
isSupported | свойство |
isSupported:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Свойству isSupported задается значение true, если текущая платформа поддерживает класс IME, в противном случае задается значение false.
Реализация
public static function get isSupported():BooleancompositionAbandoned | () | метод |
public static function compositionAbandoned():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Заставляет среду выполнения прерывать выполняемую компоновку. Этот метод следует вызывать, когда пользователь делает щелчок за пределами области компоновки или когда интерактивный объект, находящийся в фокусе, удаляется или сбрасывается. Среда выполнения подтверждает компоновку, вызовом метода confirmComposition() в клиенте. Среда выполнения также сбрасывает IME, чтобы сообщить операционной системе о том, что компоновка прервана.
compositionSelectionChanged | () | метод |
public static function compositionSelectionChanged(start:int, end:int):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Этот метод следует вызывать, когда выделенная область в пределах компоновки обновляется в результате взаимодействия пользователя или выполнения кода программы.
Параметры
start:int — Указывает смещение (в байтах) от начала выделенной области.
| |
end:int — Указывает смещение (в байтах) от конца выделенной области.
|
doConversion | () | метод |
setCompositionString | () | метод |
public static function setCompositionString(composition:String):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает строку композиции IME. Если строка задана, пользователь может выбирать варианты в редакторе IME перед тем, как отправить результаты в активное текстовое поле.
Если нет активного текстового поля, этот метод завершается с ошибкой.
Параметры
composition:String — Строка для отправки редактору IME.
|
Выдает
Error — Неудачный вызов.
|
imeComposition | Событие |
flash.events.IMEEventсвойство IMEEvent.type =
flash.events.IMEEvent.IME_COMPOSITION| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Отправляется, когда пользователь завершил работу в редакторе методов ввода (IME), и доступна строка чтения. Обычно редакторы IME применяются для ввода текста на языках, в которых используются иероглифы, а не буквы. Это такие языки как японский, корейский и китайский.
Задает значение свойстваtype для объекта события imeComposition.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект IME. |
Tue Jun 12 2018, 11:34 AM Z