JavaTM 2 Platform
Std. Ed. v1.3

java.awt.event
クラス 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 int CARET_POSITION_CHANGED
          インプットメソッドテキストでの挿入ポイントが変更されたことを示すイベントタイプです。
static int INPUT_METHOD_FIRST
          インプットメソッドイベント識別子に使う整数の範囲にある最初の番号です。
static int INPUT_METHOD_LAST
          インプットメソッドイベント識別子に使う整数の範囲にある最後の番号です。
static int INPUT_METHOD_TEXT_CHANGED
          インプットメソッドテキストが変更されたことを示すイベントタイプです。
 
クラス java.awt.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, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK
 
クラス java.util.EventObject から継承したフィールド
source
 
コンストラクタの概要
InputMethodEvent(Component source, int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)
          InputMethodEvent を構築します。
InputMethodEvent(Component source, int id, TextHitInfo caret, TextHitInfo visiblePosition)
          InputMethodEvent を構築します。
 
メソッドの概要
 void consume()
          イベントを消費して、そのイベントの発生元によってデフォルトの方法で処理されないようにします。
 TextHitInfo getCaret()
          キャレットを返します。
 int getCommittedCharacterCount()
          テキスト内の確定テキストの文字数を返します。
 AttributedCharacterIterator getText()
          確定テキストと変換テキストを結合したものを返します。
 TextHitInfo getVisiblePosition()
          優先して可視にすべき位置を返します。
 boolean isConsumed()
          このイベントが消費されたかどうかを返します。
 String paramString()
          イベントを特定するパラメータ文字列を返します。
 
クラス java.awt.AWTEvent から継承したメソッド
finalize, getID, toString
 
クラス java.util.EventObject から継承したメソッド
getSource
 
クラス java.lang.Object から継承したメソッド
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

INPUT_METHOD_FIRST

public static final int INPUT_METHOD_FIRST
インプットメソッドイベント識別子に使う整数の範囲にある最初の番号です。

INPUT_METHOD_TEXT_CHANGED

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

CARET_POSITION_CHANGED

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

INPUT_METHOD_LAST

public static final int INPUT_METHOD_LAST
インプットメソッドイベント識別子に使う整数の範囲にある最後の番号です。
コンストラクタの詳細

InputMethodEvent

public InputMethodEvent(Component source,
                        int id,
                        AttributedCharacterIterator text,
                        int committedCharacterCount,
                        TextHitInfo caret,
                        TextHitInfo visiblePosition)
InputMethodEvent を構築します。このとき、イベントの発生元のコンポーネント、タイプ、テキスト、キャレット、および visiblePosition を指定します。

キャレットと visiblePosition のオフセットは、現在の変換テキストに関連します。この場合の変換テキストは、イベントが INPUT_METHOD_TEXT_CHANGED イベントの場合は、text 内の変換テキスト、それ以外の場合は、先行する INPUT_METHOD_TEXT_CHANGED イベントの text 内の変換テキストになります。

パラメータ:
source - イベントの発生元オブジェクト
id - イベントのタイプ
text - 確定テキストと変換テキストを合わせたもの。確定テキストが優先される。イベントタイプが CARET_POSITION_CHANGED の場合は nullINPUT_METHOD_TEXT_CHANGED イベントの場合は、確定テキストまたは変換テキストがないときは null
committedCharacterCount - テキスト内の確定された文字の数
caret - キャレット (挿入ポイント)。現在の変換テキストにキャレットがない場合は null
visiblePosition - 優先して可視にすべき位置。現在の変換テキスト内に、可視にすべき位置についての指定がない場合は null
例外:
IllegalArgumentException - idINPUT_METHOD_FIRST..INPUT_METHOD_LAST の範囲にない場合、idCARET_POSITION_CHANGEDtext が null でない場合、または committedCharacterCount0..(text.getEndIndex() - text.getBeginIndex()) の範囲にない場合

InputMethodEvent

public InputMethodEvent(Component source,
                        int id,
                        TextHitInfo caret,
                        TextHitInfo visiblePosition)
InputMethodEvent を構築します。このとき、イベントの発生元のコンポーネント、タイプ、キャレット、および visiblePosition を指定します。テキストは null、committedCharacterCount は 0 に設定します。

キャレットと visiblePosition のオフセットは、現在の変換テキストに対する相対値です。この場合の変換テキストは、イベントが CARET_POSITION_CHANGED イベントとして構築された場合、先行する INPUT_METHOD_TEXT_CHANGED イベントの text 内の変換テキストになります。INPUT_METHOD_TEXT_CHANGED イベントにテキストがなかった場合、キャレットと visiblePosition は null でなければなりません。

パラメータ:
source - イベントの発生元オブジェクト
id - イベントのタイプ
caret - キャレット (挿入ポイント)。現在の変換テキストにキャレットがない場合は null
visiblePosition - 優先して可視にすべき位置。現在の変換テキスト内に、可視にすべき位置についての指定がない場合は 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()
イベントを消費して、そのイベントの発生元によってデフォルトの方法で処理されないようにします。
オーバーライド:
クラス AWTEvent 内の consume

isConsumed

public boolean isConsumed()
このイベントが消費されたかどうかを返します。
オーバーライド:
クラス AWTEvent 内の isConsumed
関連項目:
consume()

paramString

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

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

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.