- すべてのスーパー・インタフェース:
InputMethodRequests
public interface InputMethodContext extends InputMethodRequests
インプット・メソッドが、そのクライアント・コンポーネントとの通信またはほかのサービスの要求のために使用できるメソッドを提供します。 このインタフェースは、インプット・メソッド・フレームワークによって実装され、インプット・メソッドが
InputMethod.setInputMethodContext(java.awt.im.spi.InputMethodContext)
から受け取るインスタンスのメソッドを呼び出します。 これ以外の実装者または呼出し元はありません。 - 導入されたバージョン:
- 1.3
-
メソッドのサマリー
修飾子と型メソッド説明createInputMethodJFrame
(String title, boolean attachToInputContext) インプット・メソッドが使用するトップ・レベルのSwing JFrameを作成します。createInputMethodWindow
(String title, boolean attachToInputContext) インプット・メソッドが使用するトップ・レベルのウィンドウを作成します。void
dispatchInputMethodEvent
(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition) 指定された引数でインプット・メソッド・イベントを作成して、そのイベントをクライアント・コンポーネントにディスパッチします。void
enableClientWindowNotification
(InputMethod inputMethod, boolean enable) 指定されたインプット・メソッドに対する現在のクライアント・ウィンドウの位置および状態の通知を使用可能または使用不可能にします。インタフェースjava.awt.im.InputMethodRequestsで宣言されたメソッド
cancelLatestCommittedText, getCommittedText, getCommittedTextLength, getInsertPositionOffset, getLocationOffset, getSelectedText, getTextLocation
-
メソッドの詳細
-
dispatchInputMethodEvent
void dispatchInputMethodEvent(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition) 指定された引数でインプット・メソッド・イベントを作成して、そのイベントをクライアント・コンポーネントにディスパッチします。 引数については、InputMethodEvent(java.awt.Component, int, java.awt.font.TextHitInfo, java.awt.font.TextHitInfo)
を参照してください。- パラメータ:
id
- イベント・タイプtext
- コミットされたテキストと合成されたテキストcommittedCharacterCount
- テキスト内の確定された文字の数caret
- キャレット(a.k.a.挿入ポイント);現在の合成テキスト内にキャレットがない場合、nullvisiblePosition
- '可視性が最も重要で、存在する場合はnull'が現在作成されているテキスト内の可視位置に対して推奨を行わない位置
-
createInputMethodWindow
インプット・メソッドが使用するトップ・レベルのウィンドウを作成します。 このウィンドウの動作を次に示します。- すべてのドキュメント・ウィンドウとダイアログの上に表示する
- ウィンドウとその中のすべてのコンポーネントは、フォーカスを受け取らない
- タイトルのない縮小ドラッグ領域のような軽量の装飾を保持する
タイトルが表示または非表示となるかは、作成されたウィンドウの実際のタイプに依存します。
attachToInputContextがtrueの場合、新規ウィンドウは、このインプット・メソッド・コンテキストに対応した入力コンテキストを共有できます。これにより、ウィンドウにあるコンポーネントのイベントは自動的にそのインプット・メソッドにディスパッチされます。 さらに、setVisible(true)を使ってウィンドウを開いているときは、入力コンテキストによって、ほかの方法によるインプット・メソッドへの終了および起動の呼出しが防止されます。
返されたインプット・メソッド・ウィンドウが必要でなくなった場合に、インプット・メソッドは、そのインプット・メソッド・ウィンドウで
Window.dispose
を呼び出す必要があります。- パラメータ:
title
- タイトル・バーが存在する場合、ウィンドウのタイトル・バーに表示されるタイトル。null
値は、空の文字列""として処理されます。attachToInputContext
- このウィンドウが、インプット・メソッド・コンテキストに対応する入力コンテキストを共有するかどうか- 戻り値:
- インプット・メソッドが使用する特性を保持するウィンドウ
- 例外:
HeadlessException
-GraphicsEnvironment.isHeadless
がtrue
を返す場合
-
createInputMethodJFrame
インプット・メソッドが使用するトップ・レベルのSwing JFrameを作成します。 このウィンドウの動作を次に示します。- すべてのドキュメント・ウィンドウとダイアログの上に表示する
- ウィンドウとその中のすべてのコンポーネントは、フォーカスを受け取らない
- タイトルのない縮小ドラッグ領域のような軽量の装飾を保持する
タイトルが表示または非表示となるかは、作成されたウィンドウの実際のタイプに依存します。
attachToInputContextがtrueの場合、新規ウィンドウは、このインプット・メソッド・コンテキストに対応した入力コンテキストを共有できます。これにより、ウィンドウにあるコンポーネントのイベントは自動的にそのインプット・メソッドにディスパッチされます。 さらに、setVisible(true)を使ってウィンドウを開いているときは、入力コンテキストによって、ほかの方法によるインプット・メソッドへの終了および起動の呼出しが防止されます。
返されたインプット・メソッド・ウィンドウが必要でなくなった場合に、インプット・メソッドは、そのインプット・メソッド・ウィンドウで
Window.dispose
を呼び出す必要があります。- パラメータ:
title
- タイトル・バーが存在する場合、ウィンドウのタイトル・バーに表示されるタイトル。null
値は、空の文字列""として処理されます。attachToInputContext
- このウィンドウが、インプット・メソッド・コンテキストに対応する入力コンテキストを共有するかどうか- 戻り値:
- インプット・メソッドが使用する特性を保持するJFrame
- 例外:
HeadlessException
-GraphicsEnvironment.isHeadless
がtrue
を返す場合- 導入されたバージョン:
- 1.4
-
enableClientWindowNotification
void enableClientWindowNotification(InputMethod inputMethod, boolean enable) 指定されたインプット・メソッドに対する現在のクライアント・ウィンドウの位置および状態の通知を使用可能または使用不可能にします。 通知が使用可能な場合は、インプット・メソッドのnotifyClientWindowChange
メソッドが、そのメソッドの仕様に記述されているとおりに呼び出されます。 インプット・メソッドが破棄されると、通知は自動的に使用不可能になります。- パラメータ:
inputMethod
- 通知を使用可能または使用不可能にするインプット・メソッドenable
- 有効にするにはtrue、無効にするにはfalse
-