|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.im.InputContext
InputContext オブジェクトは、テキスト編集コンポーネントとインプットメソッド間の通信を管理します。InputContext オブジェクトは、両者の間でイベントをディスパッチし、インプットメソッドからテキスト編集コンポーネントへ情報の要求を転送します。また、InputContext オブジェクトは、テキスト編集コンポーネントがロケールによってインプットメソッドを選択できるようにします。
デフォルトでは、Window のインスタンスごとに 1 つの InputContext のインスタンスが生成され、この入力コンテキストはウィンドウのコンテナ階層内にあるすべてのコンポーネントによって共有されます。ただし、ウィンドウ内では 1 回に 1 つのテキスト入力オペレーションだけが可能であり、テキストコンポーネント間でフォーカスを移動するときにはテキストを確定する必要があります。これが望ましくない場合、テキストコンポーネントは独自の入力コンテキストインスタンスを生成できます。
Java 2 プラットフォームは、Java プログラミング言語で開発され、java.awt.im.spi パッケージのインタフェースを使用し、拡張機能として Java 2 実行環境にインストールされるインプットメソッドをサポートします。実装はまた、実行するプラットフォームのネイティブなインプットメソッドの使用をサポートできます。ただし、すべてのプラットフォームおよびロケールがインプットメソッドを提供するわけではありません。
インプットメソッドは、(a) Java プログラミング言語で書かれたインプットメソッドが何もインストールされておらず、(b) Java 2 実装または基本となるプラットフォームがネイティブなインプットメソッドをサポートしていない場合は、使用できません。その場合でも、入力コンテキストを作成して使用することはできます。入力コンテキストの動作は、下記の個別メソッドによって指定されます。
Component.getInputContext()
,
Component.enableInputMethods(boolean)
コンストラクタの概要 | |
protected |
InputContext()
InputContext を構築します。 |
メソッドの概要 | |
void |
dispatchEvent(AWTEvent event)
アクティブなインプットメソッドにイベントをディスパッチします。 |
void |
dispose()
入力コンテキストを破棄し、入力コンテキストが使用しているリソースを解放します。 |
void |
endComposition()
このコンテキストで現在進行中の入力変換を終了します。 |
Object |
getInputMethodControlObject()
現在のインプットメソッドの制御オブジェクトまたは null を返します。 |
static InputContext |
getInstance()
新しい InputContext インスタンスを返します。 |
Locale |
getLocale()
現在のインプットメソッドの現在のロケールを返します。 |
boolean |
isCompositionEnabled()
現在のインプットメソッドの変換が使用可能かどうか判別します。 |
void |
reconvert()
現在のインプットメソッドに、現在のクライアントコンポーネントからのテキストを再変換するよう依頼します。 |
void |
removeNotify(Component client)
包含関係の階層からクライアントコンポーネントが削除されたか、またはコンポーネントでインプットメソッドがサポートされなくなったことを入力コンテキストに通知します。 |
boolean |
selectInputMethod(Locale locale)
指定されたロケールをサポートするインプットメソッドを選択します。 |
void |
setCharacterSubsets(Character.Subset[] subsets)
この入力コンテキストのインプットメソッドで入力できる Unicode 文字セットのサブセットを設定します。 |
void |
setCompositionEnabled(boolean enable)
パラメータ enable の値に応じて、現在のインプットメソッドを変換に使用可能または不可能にします。
|
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
protected InputContext()
getInstance()
を呼び出して取得します。メソッドの詳細 |
public static InputContext getInstance()
public boolean selectInputMethod(Locale locale)
たとえば、ユーザが挿入ポイントを変更するときに、ユーザがこの挿入ポイントを囲むテキストの言語でただちに入力を続けられるように、テキスト編集コンポーネントがこのメソッドを呼び出すことがあります。
locale
- 目的の新しいロケールNullPointerException
- locale
が null の場合public Locale getLocale()
InputMethod.getLocale()
を持たない場合、null を返します。public void setCharacterSubsets(Character.Subset[] subsets)
subsets
- 文字入力に使用できる Unicode 文字セットのサブセットpublic void setCompositionEnabled(boolean enable)
enable
の値に応じて、現在のインプットメソッドを変換に使用可能または不可能にします。
変換が使用可能になっているインプットメソッドは、変換目的と制御目的の両方の受信イベントを解釈します。変換が不可能なインプットメソッドは、変換のためのイベントを解釈しません。しかし、そのメソッドが変換に使用可能かどうかに関係なく、イベントはインプットメソッドに渡されます。また、変換が不可能なインプットメソッドも、自身を変換に使用可能にするか不可能にするかを含めて、制御目的のためのイベントを解釈できます。
enable
- 現在のインプットメソッドの変換を使用可能にするかどうかUnsupportedOperationException
- 現在使用できるインプットメソッドがないか、あるいは現在のインプットメソッドが使用可能と不可能の操作をサポートしていない場合isCompositionEnabled()
public boolean isCompositionEnabled()
true
、そうでない場合は false
UnsupportedOperationException
- 現在使用できるインプットメソッドがないか、あるいは現在のインプットメソッドが、変換が使用可能かどうかの確認をサポートしていない場合setCompositionEnabled(boolean)
public void reconvert()
InputMethodRequests.getSelectedText
メソッドを使って、再変換するテキストをクライアントコンポーネントから取得します。インプットメソッドによる詳細情報の要求を処理するために、他の InputMethodRequests
メソッドを用意しておく必要があります。変換されたテキストまたは確定テキスト、あるいはその両方が、InputMethodEvent
の処理としてクライアントコンポーネントへ送られます。指定されたテキストをインプットメソッドが再変換できない場合、そのテキストが InputMethodEvent
の確定テキストとして返されます。UnsupportedOperationException
- 現在使用できるインプットメソッドがないか、あるいは現在のインプットメソッドが変換操作をサポートしていない場合public void dispatchEvent(AWTEvent event)
event
- イベントNullPointerException
- event
が null の場合public void removeNotify(Component client)
Component.removeNotify
メソッドから呼び出されます。このコンポーネントでインプットメソッドから保留中の入力がある場合、その入力は破棄されます。使用できるインプットメソッドがない場合、このメソッドは無効です。client
- クライアントコンポーネントNullPointerException
- client
が null の場合public void endComposition()
テキスト編集コンポーネントは、たとえば、ユーザがテキスト内で (変換テキストの外部に) 挿入ポイントを移動したときや、コンポーネントのテキストがファイルに保存されたり、クリップボードにコピーされたときなど、さまざまな状況でこのメソッドを呼び出すことがあります。
public void dispose()
public Object getInputMethodControlObject()
使用できるインプットメソッドがないか、あるいは現在のインプットメソッドがインプットメソッド制御オブジェクトを提供していない場合、null が返されます。
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.