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

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 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.


Общедоступные свойства
 СвойствоОпределено
 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
dispatchEvent(event:Event):Boolean
Передает событие в поток событий.
EventDispatcher
  
doConversion():void
[статические] Предписывает IME выбрать первого кандидата для текущей строки композиции.
IME
 Inherited
hasEventListener(type:String):Boolean
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
setCompositionString(composition:String):void
[статические] Задает строку композиции IME.
IME
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
toString():String
Возвращает строковое представление заданного объекта.
Object
 Inherited
valueOf():Object
Возвращает элементарное значение заданного объекта.
Object
 Inherited
willTrigger(type:String):Boolean
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
События
 Событие Сводка Определено
 Inherited
activate
[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited
deactivate
[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
  
imeComposition
Отправляется, когда пользователь завершил работу в редакторе методов ввода (IME), и доступна строка чтения.IME
Сведения о свойстве
conversionModeсвойство
conversionMode:String  [чтение и запись]

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

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


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

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

См. также

flash.system.IMEConversionMode.ALPHANUMERIC_FULL
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 function set enabled(value:Boolean):void

Выдает
Error — Попытка установки завершилась неудачно.
Сведения о методе
doConversion()метод
public static function doConversion():void

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

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


Выдает
Error — Вызов завершился с ошибкой.
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.

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

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



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Wed Sep 24 2008, 07:56 AM -07:00