IMEEvent

包	flash.events
类	public class IMEEvent
继承	IMEEvent TextEvent Event Object

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

当用户使用输入法编辑器 (IME) 输入文本时，将调度 IMEEvent 对象。IME 一般用于输入象形文字语言（例如，中文、日语和朝鲜语）的文本而不是字母。存在两个 IME 事件：IMEEvent.IME_COMPOSITION 和 IMEEvent.IME_START_COMPOSITION。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读] 事件流中的当前阶段。	Event
		imeClient : IIMEClient 指定实现 IMEClient 接口的对象。	IMEEvent
		target : Object [只读] 事件目标。	Event
		text : String 在 textInput 事件中，由用户输入的字符或字符序列。	TextEvent
		type : String [只读] 事件的类型。	Event

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		IMEEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", imeClient:IIMEClient = null) 创建一个 Event 对象，其中包含有关 IME 事件的特定信息。	IMEEvent
		clone():Event [覆盖] 创建 IMEEvent 对象的副本，并设置每个属性的值以匹配原始属性值。	IMEEvent
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String [覆盖] 返回一个字符串，其中包含 IMEEvent 对象的所有属性。	IMEEvent
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		IME_COMPOSITION : String = "imeComposition" [静态] 定义 imeComposition 事件对象的 type 属性值。	IMEEvent
		IME_START_COMPOSITION : String = "imeStartComposition" [静态] 要处理 IME 文本输入，接收方必须将事件的 imeClient 字段设置为实现 IIMEClient 接口的对象。	IMEEvent

属性详细信息

imeClient

属性

imeClient:IIMEClient

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

指定实现 IMEClient 接口的对象。基于 flash.text.engine 包的组件必须实现此接口以支持使用 IME 编辑文本内联。

实现
public function get imeClient():IIMEClient
public function set imeClient(value:IIMEClient):void

构造函数详细信息

()

构造函数

public function IMEEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", imeClient:IIMEClient = null)

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

创建一个 Event 对象，其中包含有关 IME 事件的特定信息。将 Event 对象作为参数传递给事件侦听器。

参数

	`type:String` — 事件的类型。事件侦听器可以通过继承的 `type` 属性访问此信息。只有一种 IME 事件：`IMEEvent.IME_COMPOSITION`。

	`bubbles:Boolean` (default = `false`) — 确定 Event 对象是否参与事件流的冒泡阶段。事件侦听器可以通过继承的 `bubbles` 属性访问此信息。

	`cancelable:Boolean` (default = `false`) — 确定是否可以取消 Event 对象。事件侦听器可以通过继承的 `cancelable` 属性访问此信息。

	`text:String` (default = "") — 来自 IME 的读取字符串。这是用户在选择任何候选项之前键入的初始字符串。最终合成字符串提供给 `TextEvent.TEXT_INPUT` 事件中获得键盘焦点的对象。事件侦听器可以通过 `text` 属性访问此信息。

	`imeClient:IIMEClient` (default = `null`) — 由文本引擎用来与 IME 通信的一组回调。如果您的代码有自己的文本引擎并自行渲染文本行，而不是使用 TextField 对象或 TextLayoutFramework，就非常有用。

方法详细信息

clone

()

方法

override public function clone():Event

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

创建 IMEEvent 对象的副本，并设置每个属性的值以匹配原始属性值。

Event — 其属性值与原始属性值匹配的新 IMEEvent 对象。

toString

()

方法

override public function toString():String

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

返回一个字符串，其中包含 IMEEvent 对象的所有属性。字符串的格式如下：

[IMEEvent type=value bubbles=value cancelable=value text=value]

String — 一个字符串，其中包含 IMEEvent 对象的所有属性。

常量详细信息

IME_COMPOSITION

常量

public static const IME_COMPOSITION:String = "imeComposition"

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

此事件具有以下属性：

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

相关 API 元素

flash.system.IME.imeComposition

IME_START_COMPOSITION

常量

public static const IME_START_COMPOSITION:String = "imeStartComposition"

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

要处理 IME 文本输入，接收方必须将事件的 imeClient 字段设置为实现 IIMEClient 接口的对象。如果未设置 imeClient，运行时会改用不一致的 IME 组合，并将最终组合作为 TEXT_INPUT 事件发送。

此事件具有以下属性：

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

相关 API 元素

flash.system.IME.imeComposition

法律声明 | 在线隐私策略

IMEEvent - AS3

类 x

imeClient

IMEEvent

clone

toString

IME_COMPOSITION

IME_START_COMPOSITION