flash.system.IME (Flex™ 2 リファレンスガイド)

パッケージ	flash.system
	public final class IME
継承	IME EventDispatcher Object

IME クラスを使用すると、クライアントコンピュータで実行されている Flash Player アプリケーションで、オペレーティングシステムの IME を直接操作できます。IME がインストールされているかどうか、IME が現在有効になっているかどうか、およびどの IME が有効になっているかを調べることができます。Flash Player アプリケーションで IME を無効または有効にすることができます。また、オペレーティングシステムによっては、その他の限られた機能を使用できます。

IME を使用すると、中国語、日本語、韓国語といったマルチバイトの言語で ASCII 以外の文字を入力できるようになります。IME の使用方法の詳細については、アプリケーションの開発対象である OS のマニュアルを参照してください。追加情報については、次の Web サイトを参照してください。

IME がユーザーのコンピュータでアクティブではない場合、IME のメソッドまたはプロパティの呼び出しは、Capabilities.hasIME を除き、失敗します。IME を手動でアクティブにすると、それ以降の IME のメソッドまたはプロパティの ActionScript 呼び出しは、意図したとおりに動作します。たとえば、日本語 IME を使用する場合、IME のメソッドまたはプロパティを呼び出す前にアクティブにする必要があります。

次の表に、このクラスのプラットフォーム別の対応状況を示します。

機能	Windows	Mac OSX	Mac Classic
IME がインストールされているかどうかの確認 `flash.system.Capabilities.hasIME`	可	可	可
IME のオン / オフ `flash.system.IME.enabled`	可	可	可
IME のオン / オフの確認 `flash.system.IME.enabled`	可	可	可
IME 変換モードの取得または設定 `flash.system.IME.conversionMode`	可	対応 **	不可
変換対象ストリングの IME への送信 `flash.system.IME.setCompositionString()`	対応 *	不可	不可
IME からの変換前のストリングの取得 `flash.system.System.ime.addEventListener(flash.events.IMEEvent.IME_COMPOSITION, myHandler) flash.system.System.ime.removeEventListener(flash.events.IMEEvent.IME_COMPOSITION, myHandler)`	対応 *	不可	不可
IME への変換要求の送信 `flash.system.IME.doConversion()`	対応 *	不可	不可

* 一部の Windows IME では、上記のうち一部サポートしていない操作があります。すべての操作をサポートしている IME は、日本語 IME のみです。

** Macintosh の場合は、日本語 IME でのみこれらのメソッドがサポートされており、サードパーティ製の IME ではサポートされていません。

関連項目

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] 現在の入力ストリングの第 1 候補を選択するように 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

	イベント	一覧	定義
		imeComposition	ユーザーが IME 入力を完了し、読み取りストリングが使用可能になったときに送出します。	IME

プロパティの詳細

conversionMode

プロパティ

conversionMode:String [read-write]

現在の 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

Throws

Error — 設定試行が成功しませんでした。

enabled

プロパティ

enabled:Boolean [read-write]

システム IME が有効になっているか (true) 無効になっているか (false) を示します。IME が有効であるときはマルチバイト入力になり、IME が無効であるときは英数入力になります。

実装
public static function get enabled():Boolean
public function set enabled(value:Boolean):void

Throws

Error — 設定試行が成功しませんでした。

関連項目

IME クラス

メソッドの詳細

doConversion

()

メソッド

public static function doConversion():void

現在の入力ストリングの第 1 候補を選択するように IME に指示します。

スロー

Error — 呼び出しが成功しませんでした。

setCompositionString

()

メソッド

public static function setCompositionString(composition:String):void

IME への入力ストリングを設定します。このストリングが設定されると、ユーザーは IME 候補を選択してから、現在フォーカスのあるテキストフィールドの結果を確定できます。

どのテキストフィールドにもフォーカスがない場合、このメソッドは失敗し、エラーをスローします。

パラメータ

composition:String — IME に送るストリング。

スロー

Error — 呼び出しが成功しませんでした。

イベントの詳細

imeComposition

event

イベントオブジェクトの型: flash.events.IMEEvent
IMEEvent.type property = flash.events.IMEEvent.IME_COMPOSITION

ユーザーが IME 入力を完了し、読み取りストリングが使用可能になったときに送出します。IME は、通常、日本語、中国語、韓国語など、表音文字ではなく表意文字を持つ言語のテキストを入力するために使用されます。

imeComposition イベントオブジェクトの type プロパティ値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	IME オブジェクトです。

関連項目

IME クラス

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class IME	プロパティ \| メソッド \| イベント