クラスInputMethodEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.InputMethodEvent
すべての実装されたインタフェース:
Serializable
public class InputMethodEvent extends AWTEvent
インプット・メソッド・イベントには、インプット・メソッドで構成されているテキストについての情報が含まれています。 インプット・メソッドは、テキストが変更されたときにイベントを送信します。 現在インプット・メソッドを使用しているテキスト・コンポーネントがアクティブ・クライアントである場合は、イベントはそのコンポーネントにディスパッチされます。 それ以外の場合は、イベントは別個の構成ウィンドウにディスパッチされます。

インプット・メソッド・イベントに含まれているテキストは、確定テキストと構成テキストの2つの部分から構成されています。 どちらの部分も空の場合があります。 2つの部分はともに、直前のイベントで送られた未確定の構成テキスト、または現在選択されている確定テキストを置き換えます。 確定テキストはテキスト・コンポーネントの永続データに統合されるはずで、再度送信されることはありません。 構成テキストは、ユーザーの編集オペレーションを反映するための変更によって、繰返し送信できます。 確定テキストは構成テキストよりも常に優先されます。

導入されたバージョン:
1.2
関連項目:

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final int
    CARET_POSITION_CHANGED
    インプット・メソッド・テキストで挿入ポイントが変更されたことを示すイベント・タイプです。
    static final int
    INPUT_METHOD_FIRST
    インプット・メソッド・イベントID範囲の最初の整数IDをマークします。
    static final int
    INPUT_METHOD_LAST
    インプット・メソッド・イベントID範囲の最後の整数IDをマークします
    static final int
    INPUT_METHOD_TEXT_CHANGED
    インプット・メソッド・テキストが変更されたことを示すイベント・タイプです。

    クラスで宣言されたフィールド AWTEvent

    ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK
    修飾子と型
    フィールド
    説明
    static final long
    ACTION_EVENT_MASK
    アクション・イベント選択用イベント・マスクです。
    static final long
    ADJUSTMENT_EVENT_MASK
    調整イベント選択用イベント・マスクです。
    static final long
    COMPONENT_EVENT_MASK
    コンポーネント・イベント選択用イベント・マスクです。
    protected boolean
    consumed
    転送元の処理後にイベントをピアに送り返すかどうかを制御します。trueの場合は送り返されず、falseの場合は送り返されます。
    static final long
    CONTAINER_EVENT_MASK
    コンテナ・イベント選択用イベント・マスクです。
    static final long
    FOCUS_EVENT_MASK
    フォーカス・イベント選択用イベント・マスクです。
    static final long
    HIERARCHY_BOUNDS_EVENT_MASK
    階層境界イベント選択用イベント・マスクです。
    static final long
    HIERARCHY_EVENT_MASK
    階層イベント選択用イベント・マスクです。
    protected int
    id
    イベントのID
    static final long
    INPUT_METHOD_EVENT_MASK
    インプット・メソッド・イベント選択用イベント・マスクです。
    static final long
    INVOCATION_EVENT_MASK
    呼出しイベント選択用イベント・マスクです。
    static final long
    ITEM_EVENT_MASK
    項目イベント選択用イベント・マスクです。
    static final long
    KEY_EVENT_MASK
    キー・イベント選択用イベント・マスクです。
    static final long
    MOUSE_EVENT_MASK
    マウス・イベント選択用イベント・マスクです。
    static final long
    MOUSE_MOTION_EVENT_MASK
    マウス・モーション・イベント選択用イベント・マスクです。
    static final long
    MOUSE_WHEEL_EVENT_MASK
    マウス・ホイール・イベント選択用イベント・マスクです。
    static final long
    PAINT_EVENT_MASK
    ペイント・イベント選択用イベント・マスクです。
    static final int
    RESERVED_ID_MAX
    予約済みAWTイベントIDの最大値です。
    static final long
    TEXT_EVENT_MASK
    テキスト・イベント選択用イベント・マスクです。
    static final long
    WINDOW_EVENT_MASK
    ウィンドウ・イベント選択用イベント・マスクです。
    static final long
    WINDOW_FOCUS_EVENT_MASK
    ウィンドウ・フォーカス・イベント選択用イベント・マスクです。
    static final long
    WINDOW_STATE_EVENT_MASK
    ウィンドウ状態イベント選択用イベント・マスクです。

    クラスで宣言されたフィールド EventObject

    source
    修飾子と型
    フィールド
    説明
    protected Object
    source
    Eventが最初に発生したオブジェクト。

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    InputMethodEvent(Component source, int id, long when, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)
    指定されたソース・コンポーネント、型、時間、text、caret、およびvisiblePositionで、InputMethodEventを構築します。
    InputMethodEvent(Component source, int id, TextHitInfo caret, TextHitInfo visiblePosition)
    指定されたソース・コンポーネント、型、caret、およびvisiblePositionで、InputMethodEventを構築します。
    InputMethodEvent(Component source, int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)
    指定されたソース・コンポーネント、型、text、caret、およびvisiblePositionで、InputMethodEventを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    consume()
    このイベントを消費して、発生させたソースによりデフォルトの方法で処理されないようにします。
    TextHitInfo
    getCaret()
    キャレットを取得します。
    int
    getCommittedCharacterCount()
    テキスト内の確定文字数を取得します。
    AttributedCharacterIterator
    getText()
    結合された確定および構成テキストを取得します。
    TextHitInfo
    getVisiblePosition()
    もっとも重要な可視にする位置を取得します。
    long
    getWhen()
    このイベントが発生した時点のタイムスタンプを返します。
    boolean
    isConsumed()
    このイベントが消費されたかどうかを返します。
    String
    paramString()
    このイベントを特定するパラメータ文字列を返します。

    クラスで宣言されたメソッド AWTEvent

    getID, setSource, toString
    修飾子と型
    メソッド
    説明
    int
    getID()
    イベント・タイプを返します。
    void
    setSource(Object newSource)
    イベントを新しいソースにターゲット変更します。
    String
    toString()
    このオブジェクトの文字列表現を返します。

    クラスで宣言されたメソッド EventObject

    getSource
    修飾子と型
    メソッド
    説明
    Object
    getSource()
    Eventが最初に発生したオブジェクト。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • INPUT_METHOD_FIRST

      @Native public static final int INPUT_METHOD_FIRST
      インプット・メソッド・イベントID範囲の最初の整数IDをマークします。
      関連項目:

    • INPUT_METHOD_TEXT_CHANGED

      @Native public static final int INPUT_METHOD_TEXT_CHANGED
      インプット・メソッド・テキストが変更されたことを示すイベント・タイプです。 このイベントは、入力の処理中に、インプット・メソッドによって生成されます。
      関連項目:

    • CARET_POSITION_CHANGED

      @Native public static final int CARET_POSITION_CHANGED
      インプット・メソッド・テキストで挿入ポイントが変更されたことを示すイベント・タイプです。 このイベントは、入力の処理中にキャレットが変更された場合にだけ、インプット・メソッドによって生成されます。
      関連項目:

    • INPUT_METHOD_LAST

      @Native public static final int INPUT_METHOD_LAST
      インプット・メソッド・イベントID範囲の最後の整数IDをマークします
      関連項目:

  • コンストラクタの詳細

    • InputMethodEvent

      public InputMethodEvent(Component source, int id, long when, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)
      指定されたソース・コンポーネント、型、時間、text、caret、およびvisiblePositionで、InputMethodEventを構築します。

      caretとvisiblePositionのオフセットは、現在の構成テキスト(INPUT_METHOD_TEXT_CHANGEDイベントの場合はtext内の構成テキスト、それ以外の場合は直前のINPUT_METHOD_TEXT_CHANGEDイベントのtext内の構成テキスト)を基準とします。

      無効なidを渡すと、未指定の動作になります。 このメソッドはsourceがnullの場合にIllegalArgumentExceptionをスローします。

      パラメータ:
      source - イベントが発生したオブジェクト
      id - イベント・タイプ
      when - イベントが発生した時間を指定するlong整数
      text - 結合された確定および構成テキスト、確定テキストが最初。イベント・タイプがCARET_POSITION_CHANGEDのときはnullである必要がある。INPUT_METHOD_TEXT_CHANGEDイベントのときは、確定テキストまたは構成テキストがない場合はnullでも可
      committedCharacterCount - テキスト内の確定された文字の数
      caret - キャレット(挿入ポイント)。現在の構成テキストにキャレットがない場合はnull
      visiblePosition - 可視にするもっとも重要な位置。現在の構成テキスト内に可視位置の推奨がない場合はnull
      スロー:
      IllegalArgumentException - idがINPUT_METHOD_FIRST.-.INPUT_METHOD_LAST範囲にない場合、IDがCARET_POSITION_CHANGEDでtextがnullでない場合、またはcommittedCharacterCountが0.-.(text.getEndIndex() - text.getBeginIndex())範囲にない場合
      IllegalArgumentException - sourceがnullである場合
      導入されたバージョン:
      1.4

    • InputMethodEvent

      public InputMethodEvent(Component source, int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)
      指定されたソース・コンポーネント、型、text、caret、およびvisiblePositionで、InputMethodEventを構築します。

      caretとvisiblePositionのオフセットは、現在の構成テキスト(INPUT_METHOD_TEXT_CHANGEDイベントの場合はtext内の構成テキスト、それ以外の場合は直前のINPUT_METHOD_TEXT_CHANGEDイベントのtext内の構成テキスト)を基準とします。 このイベントのタイムスタンプは、EventQueue.getMostRecentEventTime()を呼び出すことで初期化されます。

      無効なidを渡すと、未指定の動作になります。 このメソッドはsourceがnullの場合にIllegalArgumentExceptionをスローします。

      パラメータ:
      source - イベントが発生したオブジェクト
      id - イベント・タイプ
      text - 結合された確定および構成テキスト、確定テキストが最初。イベント・タイプがCARET_POSITION_CHANGEDのときはnullである必要がある。INPUT_METHOD_TEXT_CHANGEDイベントのときは、確定テキストまたは構成テキストがない場合はnullでも可
      committedCharacterCount - テキスト内の確定された文字の数
      caret - キャレット(挿入ポイント)。現在の構成テキストにキャレットがない場合はnull
      visiblePosition - 可視にするもっとも重要な位置。現在の構成テキスト内に可視位置の推奨がない場合はnull
      スロー:
      IllegalArgumentException - idがINPUT_METHOD_FIRST.-.INPUT_METHOD_LAST範囲にない場合、IDがCARET_POSITION_CHANGEDでtextがnullでない場合、またはcommittedCharacterCountが0.-.(text.getEndIndex() - text.getBeginIndex())範囲にない場合
      IllegalArgumentException - sourceがnullである場合

    • InputMethodEvent

      public InputMethodEvent(Component source, int id, TextHitInfo caret, TextHitInfo visiblePosition)
      指定されたソース・コンポーネント、型、caret、およびvisiblePositionで、InputMethodEventを構築します。 テキストはnull、committedCharacterCountは0に設定されます。

      caretとvisiblePositionのオフセットは、現在の構成テキスト(イベントがCARET_POSITION_CHANGEDイベントとして構築されている場合は、直前のINPUT_METHOD_TEXT_CHANGEDイベントのtext内の構成テキスト)を基準とします。 テキストなしのINPUT_METHOD_TEXT_CHANGEDの場合は、caretとvisiblePositionはnullである必要があります。 このイベントのタイムスタンプは、EventQueue.getMostRecentEventTime()を呼び出すことで初期化されます。

      無効なidを渡すと、未指定の動作になります。 このメソッドはsourceがnullの場合にIllegalArgumentExceptionをスローします。

      パラメータ:
      source - イベントが発生したオブジェクト
      id - イベント・タイプ
      caret - キャレット(挿入ポイント)。現在の構成テキストにキャレットがない場合はnull
      visiblePosition - 可視にするもっとも重要な位置。現在の構成テキスト内に可視位置の推奨がない場合はnull
      スロー:
      IllegalArgumentException - idがINPUT_METHOD_FIRST.-.INPUT_METHOD_LASTの範囲内にない場合
      IllegalArgumentException - sourceがnullである場合

  • メソッドの詳細

    • getText

      public AttributedCharacterIterator getText()
      結合された確定および構成テキストを取得します。 インデックス0 - getCommittedCharacterCount() - 1の文字が確定テキストで、残りの文字が構成テキストです。
      戻り値:
      テキスト CARET_POSITION_CHANGEDイベントの場合は常にnull; INPUT_METHOD_TEXT_CHANGEDイベントの場合は、構成テキストまたは確定テキストがないときはnullでも可。

    • getCommittedCharacterCount

      public int getCommittedCharacterCount()
      テキスト内の確定文字数を取得します。
      戻り値:
      テキスト内のコミットされた文字の数

    • getCaret

      public TextHitInfo getCaret()
      キャレットを取得します。

      キャレットのオフセットは、現在の構成テキスト(INPUT_METHOD_TEXT_CHANGEDイベントの場合はgetText()内の構成テキスト、それ以外の場合は直前のINPUT_METHOD_TEXT_CHANGEDイベントのgetText()内の構成テキスト)を基準とします

      戻り値:
      キャレット(挿入ポイント)。 現在の構成テキストにキャレットがない場合はnull

    • getVisiblePosition

      public TextHitInfo getVisiblePosition()
      もっとも重要な可視にする位置を取得します。

      可視位置のオフセットは、現在の構成テキスト(INPUT_METHOD_TEXT_CHANGEDイベントの場合はgetText()内の構成テキスト、それ以外の場合は直前のINPUT_METHOD_TEXT_CHANGEDイベントのgetText()内の構成テキスト)を基準とします

      戻り値:
      もっとも重要な可視にする位置。 現在の構成テキスト内に可視位置の推奨がない場合はnull

    • consume

      public void consume()
      このイベントを消費して、発生させたソースによりデフォルトの方法で処理されないようにします。
      オーバーライド:
      consume、クラスAWTEvent

    • isConsumed

      public boolean isConsumed()
      このイベントが消費されたかどうかを返します。
      オーバーライド:
      isConsumed、クラスAWTEvent
      戻り値:
      このイベントが消費された場合true; そうでなければfalse
      関連項目:

    • getWhen

      public long getWhen()
      このイベントが発生した時点のタイムスタンプを返します。
      戻り値:
      このイベントのタイムスタンプ
      導入されたバージョン:
      1.4

    • paramString

      public String paramString()
      このイベントを特定するパラメータ文字列を返します。 このメソッドは、イベント・ログの作成およびデバッグに便利です。 テキスト形式のイベントID、「+」によって区切られた確定テキストおよび構成テキストの文字、確定文字数、キャレット、可視位置が含まれます。
      オーバーライド:
      paramString、クラスAWTEvent
      戻り値:
      イベントを特定する文字列とその属性