flash.system.IME (ActionScript 3.0)

包	flash.system
类	public final class IME
继承	IME EventDispatcher Object

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

使用 IME 类，您可以在客户端计算机上运行的 Flash Player 应用程序中直接操纵操作系统的输入法编辑器 (IME)。可以确定是否安装了 IME、当前是否启用了 IME 以及启用了哪个 IME。您可以在 Flash Player 应用程序中禁用或启用 IME，并且可以执行其它受限制的函数，具体取决于操作系统。

利用 IME，用户可键入多字节语言（例如，中文、日语和韩语）的非 ASCII 文本字符。有关使用 IME 的详细信息，请参阅要为其开发应用程序的操作系统的文档。若要获取其它资源，请参阅以下网站：

如果用户计算机上 IME 未处于活动状态，则对 IME 方法或属性（除 Capabilities.hasIME 之外）的调用将会失败。一旦手动激活 IME，随后对 IME 方法和属性的 ActionScript 调用即会正常运行。例如，如果使用日语 IME，则必须在调用任何 IME 方法或属性之前将它激活。

下表显示了此类适用的平台范围：

功能	Windows	Mac OSX
确定是否已安装 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。

另请参见

使用 IME 类

	属性	定义方
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		conversionMode : String [static] 当前 IME 的转换模式。	IME
		enabled : Boolean [static] 指示系统 IME 已启用 (true) 还是已禁用 (false)。	IME
		prototype : Object [static] 对类或函数对象的原型对象的引用。	Object

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		doConversion():void [static] 指示 IME 为当前复合字符串选择第一个候选项。	IME
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setCompositionString(composition:String):void [static] 设置 IME 复合字符串。	IME
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

摘要	定义方
activate	Flash Player 获得操作系统焦点并变为活动状态时调度。	EventDispatcher
deactivate	Flash Player 失去操作系统焦点并变为非活动状态时调度。	EventDispatcher
imeComposition	当用户完成输入法编辑器 (IME) 的输入且读取字符串可用时进行调度。	IME

属性详细信息

conversionMode

属性

conversionMode:String [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

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):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
使用 IME 类

enabled

属性

enabled:Boolean [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指示系统 IME 已启用 (true) 还是已禁用 (false)。启用的 IME 执行多字节输入；禁用的 IME 执行字母数字输入。

实现
public static function get enabled():Boolean
public function set enabled(value:Boolean):void

引发

Error — 设置尝试未成功。

另请参见

使用 IME 类

方法详细信息

doConversion

()

方法

public static function doConversion():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指示 IME 为当前复合字符串选择第一个候选项。

引发

Error — 调用未成功。

setCompositionString

()

方法

public static function setCompositionString(composition:String):void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

设置 IME 复合字符串。设置了此字符串后，用户就可以在将结果提交到当前具有焦点的文本字段之前选择 IME 候选项。

如果不存在具有焦点的文本字段，则此方法将会失败并引发错误。

参数

composition:String — 要发送到 IME 的字符串。

引发

Error — 调用未成功。

事件详细信息

imeComposition

事件

事件对象类型: flash.events.IMEEvent
IMEEvent.type property = flash.events.IMEEvent.IME_COMPOSITION

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

当用户完成输入法编辑器 (IME) 的输入且读取字符串可用时进行调度。使用 IME 进行输入的文本通常来自使用表意文字而非字母的语言，如日语、中文和韩语。

定义 imeComposition 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	IME 对象。

另请参见

使用 IME 类

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/system/IME.html

ActionScript 3.0 语言和组件参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 帧无帧
IME	属性 \| 方法 \| 事件