IME - Adobe ActionScript® 3 (AS3 ) API 參考

套件	flash.system
類別	public final class IME
繼承	IME EventDispatcher Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

IME 類別可以讓您在用戶端電腦上執行的 Flash 執行階段應用程式內，直接操作作業系統的輸入法編輯器 (IME)。您可以判斷某個 IME 是否已安裝、該 IME 是否已啟用，以及啟用的是哪個 IME。您可以在應用程式中停用或啟用 IME，也可以根據作業系統執行其他幾個為數不多的函數。

AIR 描述檔支援：桌上型電腦作業系統都支援此項功能，但所有行動裝置都不支援。AIR for TV 裝置也不支援。您可以使用 IME.isSupported 屬性測試執行階段的支援狀況。如需有關跨多個描述檔之 API 支援的詳細資訊，請參閱 AIR 描述檔支援。

輸入法編輯器讓使用者能用多位元組語言 (如中文、日文及韓文) 鍵入非 ASCII 的文字字元。如需有關使用 IME 的詳細資訊，請參閱您在為其開發應用程式之作業系統的文件。如需其他資源，請參閱下列網站：

如果 IME 未在使用者的電腦上啟用，呼叫 Capabilities.hasIME 之外的 IME 方法或屬性便會失敗。一旦您以手動方式啟用 IME，對於 IME 方法和屬性的後續 ActionScript 呼叫都會如預期地發揮作用。例如，如果您在使用日文 IME，就必須在呼叫任何 IME 方法或屬性之前啟用該 IME。

下表說明這個類別在各平台上的適用性：

功能	Windows	Mac OSX	Linux
判斷是否已安裝 IME： `Capabilities.hasIME`	是	是	是
設定啟用或停用 IME： `IME.enabled`	是	是	是
查明 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
		isSupported : Boolean [靜態] [唯讀] 如果目前的平台提供 IME 類別，則 isSupported 屬性會設為 true，否則會設為 false。	IME

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		compositionAbandoned():void [靜態] 造成執行階段放棄任何處理中的撰寫。	IME
		compositionSelectionChanged(start:int, end:int):void [靜態] 當撰寫內的選取範圍已經以互動方式或是程式設計方式更新時，呼叫這個方法。	IME
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		doConversion():void [靜態] 指示 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 [靜態] 設定 IME 組成字串。	IME
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

事件

按一下以瞭解事件的詳細資訊

隱藏繼承事件

顯示繼承事件

	摘要	定義自
activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher
imeComposition	在使用者完成輸入法編輯器 (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 static function set conversionMode(value:String):void

擲回值

Error — 設定嘗試未成功。

enabled

屬性

enabled:Boolean

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

指出系統 IME 為啟用 (true) 或停用 (false)。啟用的 IME 將執行多位元組輸入，而停用的 IME 將執行英數字母輸入。

實作
public static function get enabled():Boolean
public static function set enabled(value:Boolean):void

擲回值

Error — 設定嘗試未成功。

isSupported

屬性

isSupported:Boolean [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2

如果目前的平台提供 IME 類別，則 isSupported 屬性會設為 true，否則會設為 false。

實作
public static function get isSupported():Boolean

方法詳細資訊

compositionAbandoned

()

方法

public static function compositionAbandoned():void

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2

造成執行階段放棄任何處理中的撰寫。當使用者按下撰寫區域以外的位置時，或是當具有焦點的互動物件已經刪除或重設時，呼叫這個方法。執行階段會呼叫用戶端的 confirmComposition() 來確認撰寫。執行階段也會重設 IME 以通知作業系統，已經放棄撰寫。

compositionSelectionChanged

()

方法

public static function compositionSelectionChanged(start:int, end:int):void

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2

當撰寫內的選取範圍已經以互動方式或是程式設計方式更新時，呼叫這個方法。

參數

	`start:int` — 指定選取範圍開始的偏移量，以位元組為單位。

	`end:int` — 指定選取範圍結束的偏移量，以位元組為單位。

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 事件物件)。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	IME 物件。

法律聲明 | 線上隱私權政策

IME - AS3

類別 x

conversionMode

enabled

isSupported

compositionAbandoned

compositionSelectionChanged

doConversion

setCompositionString

imeComposition