| パッケージ | flash.system |
| クラス | public final class IME |
| 継承 | IME  EventDispatcher Object |
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0, Flash Player 9 |
AIR プロファイルのサポート：この機能はデスクトップオペレーティングシステムではサポートされますが、すべてのモバイルデバイスではサポートされませんまた、AIR for TV デバイスでもサポートされません。IME.isSupported プロパティを使用して、サポートされているかどうかを実行時にテストすることができます。複数のプロファイル間での API サポートについて詳しくは、AIR プロファイルのサポートを参照してください。
IME を使用すると、中国語、日本語、韓国語といったマルチバイトの言語で ASCII 以外の文字を入力できるようになります。IME の使用方法の詳細については、アプリケーションの開発対象である OS のマニュアルを参照してください。追加情報については、次の Web サイトを参照してください。
- http://www.microsoft.com/globaldev/default.mspx
- http://developer.apple.com/documentation/
- http://java.sun.com
IME がユーザーのコンピューターでアクティブではない場合、IME のメソッドまたはプロパティの呼び出しは、Capabilities.hasIME を除き、失敗します。IME を手動でアクティブにすると、それ以降の IME のメソッドまたはプロパティの ActionScript 呼び出しは、意図したとおりに動作します。例えば、日本語 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 | |
[静的]
進行中の入力はすべてランタイムによって破棄されます。 | IME | ||
[静的]
入力内の選択範囲が対話的またはプログラムによって更新されたときに、このメソッドを呼び出します。 | IME | ||
|
イベントをイベントフローに送出します。 | EventDispatcher | |
[静的]
現在の入力ストリングの第 1 候補を選択するように IME に指示します。 | IME | ||
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
[静的]
IME への入力ストリングを設定します。 | IME | ||
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
| イベント | 概要 | 定義元 | ||
|---|---|---|---|---|
| [ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。 | EventDispatcher | ||
| [ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。 | EventDispatcher | ||
| ユーザーが IME 入力を完了し、読み取りストリングが使用可能になったときに送出されます。 | IME | |||
conversionMode | プロパティ |
conversionMode:String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0, Flash Player 9 |
現在の IME の変換モードです。変換モードを示す、次の IME モードストリング定数を指定できます。
ALPHANUMERIC_FULLALPHANUMERIC_HALFCHINESEJAPANESE_HIRAGANAJAPANESE_KATAKANA_FULLJAPANESE_KATAKANA_HALFKOREANUNKNOWN（読み取り専用の値であり、設定できません）
実装
public static function get conversionMode():String public static function set conversionMode(value:String):void例外
Error — 設定試行が成功しませんでした。
|
関連する API エレメント
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
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 | プロパティ |
compositionAbandoned | () | メソッド |
public static function compositionAbandoned():void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 10.1, AIR 2 |
進行中の入力はすべてランタイムによって破棄されます。入力領域の外側をユーザーがクリックしたとき、またはフォーカスがあるインタラクティブオブジェクトが破棄されたかリセットされたときに、このメソッドを呼び出します。ランタイムは、クライアントで confirmComposition() を呼び出すことによって、入力を確定します。さらに、ランタイムは IME をリセットして、入力が破棄されたことをオペレーティングシステムに通知します。
compositionSelectionChanged | () | メソッド |
doConversion | () | メソッド |
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 オブジェクトです。 |
Tue Jun 12 2018, 10:34 AM Z