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 の使用方法の詳細については、アプリケーションの開発対象である OS のマニュアルを参照してください。追加情報については、次の Web サイトを参照してください。

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

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

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

* 一部の 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] 現在の入力ストリングの第 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

概要	定義元
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 — 設定試行が成功しませんでした。

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

現在の入力ストリングの第 1 候補を選択するように 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 は、通常、日本語、中国語、韓国語など、表音文字ではなく表意文字を持つ言語のテキストを入力するために使用されます。

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

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

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

関連項目

IME クラスの使用

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/flash/system/IME.html

ActionScript 3.0 コンポーネントリファレンスガイド		すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレームフレームなし
IME	プロパティ \| メソッド \| イベント