Главная / Action Script 3
Пакетflash.system
Классpublic final class IME
НаследованиеIME Inheritance EventDispatcher Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Класс IME позволяет непосредственно управлять редактором методов ввода (IME) операционной системы в приложении Flash Player, работающем на клиентском компьютере. Можно определить, был ли установлен редактор IME, был или нет этот IME включен в данный момент, а также, какой редактор IME включен. Можно включить или выключить редактор IME в приложении Flash Player, а также выполнить другие ограниченные функции, зависящие от операционной системы.

Редакторы IME позволяют пользователям вводить тексты с символами, отличными от ASCII, используя многобайтовые языки, такие как китайский, японский и корейский. Дополнительные сведения о работе с редактором IME см. в документации по операционной системе, для которой разрабатывается приложение. Дополнительные ресурсы доступны на следующих веб-сайтах:

Если редактор IME не активен на компьютере пользователя, то обращения к методам или свойствам IME, отличным от Capabilities.hasIME, будут завершаться ошибками. Как только редактор IME будет активирован вручную, последующие обращения ActionScript к методам и свойствам IME будут срабатывать ожидаемым образом. Например, если используется японский редактор IME, он должен быть активирован до того, как вызывается любой метод или свойство IME.

В следующей таблице показаны платформы, поддерживаемые данным классом:

ВозможностьWindowsMac OSX
Определяет, установлен ли редактор 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.

См. также

Использование класса IME


Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  conversionMode : String
[статические] Режим преобразования текущего IME.
IME
  enabled : Boolean
[статические] Показывает, включен ли системный IME: да (true) или нет (false).
IME
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
Общедоступные методы
 МетодОпределено
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
 Inherited
Передает событие в поток событий.
EventDispatcher
  
[статические] Предписывает IME выбрать первого кандидата для текущей строки композиции.
IME
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
[статические] Задает строку композиции IME.
IME
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
  Отправляется, когда пользователь завершил работу в редакторе методов ввода (IME), и доступна строка чтения.IME
Сведения о свойстве
conversionModeсвойство
conversionMode:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Режим преобразования текущего IME. Возможными значениями являются строковые константы режима IME, указывающие режим преобразования:



Реализация
    public static function get conversionMode():String
    public function set conversionMode(value:String):void

Выдает
Error — Попытка установки завершилась неудачно.

См. также

enabledсвойство 
enabled:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Указывает, включен ли системный редактор IME (значение true) или выключен (значение false). Если редактор IME включен, можно выполнять ввод в многобайтовой кодировке; а если выключен — только буквенно-символьный ввод.



Реализация
    public static function get enabled():Boolean
    public function set enabled(value:Boolean):void

Выдает
Error — Попытка установки завершилась неудачно.

См. также

Сведения о методе
doConversion()метод
public static function doConversion():void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

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


Выдает
Error — Вызов завершился с ошибкой.
setCompositionString()метод 
public static function setCompositionString(composition:String):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает строку композиции IME. Если строка задана, пользователь может выбирать варианты в редакторе IME перед тем как отправить результаты в активное текстовое поле.

Если нет активного текстового поля, этот метод завершается с ошибкой.

Параметры

composition:String — Строка для отправки редактору IME.


Выдает
Error — Неудачный вызов.
Сведения о событии
imeComposition Событие
Тип объекта события: flash.events.IMEEvent
свойство IMEEvent.type = flash.events.IMEEvent.IME_COMPOSITION

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

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

Задает значение свойства type для объекта события imeComposition.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект IME.

См. также