| 包 | flash.system |
| 类 | public final class IME |
| 继承 | IME  EventDispatcher Object |
| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
利用 IME，用户可键入多字节语言（例如，中文、日语和韩语）的非 ASCII 文本字符。有关使用 IME 的详细信息，请参阅要为其开发应用程序的操作系统的文档。若要获取其它资源，请参阅以下网站：
如果用户计算机上 IME 未处于活动状态，则对 IME 方法或属性（除 Capabilities.hasIME 之外）的调用将会失败。一旦手动激活 IME，随后对 IME 方法和属性的 ActionScript 调用即会正常运行。例如，如果使用日语 IME，则必须在调用任何 IME 方法或属性之前将它激活。
下表显示了此类适用的平台范围：
| 功能 | Windows | Mac OSX | Linux |
|---|---|---|---|
确定是否已安装 IME：Capabilities.hasIME
| 是 | 是 | 是 |
将 IME 设置为启用或禁用状态：IME.enabled
| 是 | 是 | 是 |
查明是启用 IME 还是禁用 IME：IME.enabled
| 是 | 是 | 是 |
获取或设置 IME 转换模式：IME.conversionMode
| 是 | 是** | 否 |
向 IME 发送要转换的字符串：IME.setCompositionString()
| 是 * | 否 | 否 |
在转换之前从 IME 获取原始字符串：System.ime.addEventListener()
| 是 * | 否 | 否 |
将转换请求发送到 IME：IME.doConversion()
| 是 * | 否 | 否 |
* 并非所有 Windows IME 都支持上述全部操作。唯一支持全部操作的 IME 是日语 IME。
** 在 Macintosh 上，只有日语 IME 支持这些方法，第三方 IME 不支持这些方法。
此类的 ActionScript 3.0 版本不支持 Macintosh Classic。
另请参见
| 属性 | 定义方 | ||
|---|---|---|---|
 | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| conversionMode : String [静态] 当前 IME 的转换模式。 | IME | ||
| enabled : Boolean [静态] 指示系统 IME 已启用 (true) 还是已禁用 (false)。 | IME | ||
| prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | |
| 方法 | 定义方 | ||
|---|---|---|---|
| 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 | |
| 检查是否用此 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_FULL
ALPHANUMERIC_HALF
CHINESE
JAPANESE_HIRAGANA
JAPANESE_KATAKANA_FULL
JAPANESE_KATAKANA_HALF
KOREAN
UNKNOWN（只读值；此值不能设置）
public static function get conversionMode():String public function set conversionMode(value:String):voidError — 设置尝试未成功。 |
另请参见
| enabled | 属性 |
enabled:Boolean [读写] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
指示系统 IME 已启用 (true) 还是已禁用 (false)。启用的 IME 执行多字节输入；禁用的 IME 执行字母数字输入。
public static function get enabled():Boolean public function set enabled(value:Boolean):voidError — 设置尝试未成功。 |
另请参见
| compositionAbandoned | () | 方法 |
public static function compositionAbandoned():void| compositionSelectionChanged | () | 方法 |
| 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.IMEEventflash.events.IMEEvent.IME_COMPOSITION| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 Flash Player 9 |
当用户完成输入法编辑器 (IME) 的输入且读取字符串可用时进行调度。使用 IME 进行输入的文本通常来自使用表意文字而非字母的语言，如日语、中文和韩语。
定义imeComposition 事件对象的 type 属性值。
此事件具有以下属性：
| 属性 | 值 |
|---|---|
bubbles
|
false
|
cancelable
|
false；没有要取消的默认行为。
|
currentTarget
| 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target
| IME 对象。 |
另请参见