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

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 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 のメソッドまたはプロパティを呼び出す前にアクティブにする必要があります。

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

機能WindowsMac OSXLinux
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 をサポートしていません。

関連項目

Using the IME class

パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  conversionMode : String
[静的] 現在の IME の変換モードです。
IME
  enabled : Boolean
[静的] システム IME が有効になっているか (true) 無効になっているか (false) を示します。
IME
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義元
 Inherited
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
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
  
doConversion():void
[静的] 現在の入力ストリングの第 1 候補を選択するように IME に指示します。
IME
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
  
setCompositionString(composition:String):void
[静的] IME への入力ストリングを設定します。
IME
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited
activate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited
deactivate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
  
imeComposition
ユーザーが IME 入力を完了し、読み取りストリングが使用可能になったときに送出されます。IME
プロパティの詳細
conversionModeプロパティ
conversionMode:String

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

現在の IME の変換モードです。変換モードを示す、次の IME モードストリング定数を指定できます。



実装
    public static function get conversionMode():String
    public function set conversionMode(value:String):void

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

関連項目

flash.system.IMEConversionMode.ALPHANUMERIC_FULL
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
Using the IME class
enabledプロパティ 
enabled:Boolean

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

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



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

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

関連項目

Using the IME class
メソッドの詳細
compositionAbandoned()メソッド
public static function compositionAbandoned():void

compositionSelectionChanged()メソッド 
public static function compositionSelectionChanged(start:int, end:int):void

パラメータ

start:int
 
end:int

doConversion()メソッド 
public static function doConversion():void

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

現在の入力ストリングの第 1 候補を選択するように 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 イベントオブジェクト) の値を定義します。

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

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

関連項目

Using the IME class



© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/system/IME.html