|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.util.EventObject | +--java.awt.AWTEvent | +--java.awt.event.InputMethodEvent
インプットメソッドイベントには、インプットメソッドを利用して変換されているテキストについての情報が含まれています。インプットメソッドは、テキストが変更されると必ずイベントを送信します。現在インプットメソッドを使用しているテキストコンポーネントがアクティブクライアントである場合は、イベントはそのコンポーネントにディスパッチされます。それ以外の場合は、イベントは離れた変換ウィンドウにディスパッチされます。
インプットメソッドイベントに含まれているテキストは、確定テキストと、変換テキストの 2 つの部分から構成されています。どちらの部分も空の場合があります。2 つの部分はともに、直前のイベントで送られた未確定の変換テキスト、または現在選択されている確定テキストを置き換えます。確定テキストは、テキストコンポーネントの持続的なデータに統合されます。そうすれば、再度送信されることはありません。変換テキストは、ユーザの編集オペレーションを反映する変更とともに、繰り返し送信される場合があります。確定テキストは必ず変換テキストよりも優先されます。
フィールドの概要 | |
static int |
CARET_POSITION_CHANGED
インプットメソッドテキストでの挿入ポイントが変更されたことを示すイベントタイプです。 |
static int |
INPUT_METHOD_FIRST
インプットメソッドイベント識別子に使う整数の範囲にある最初の番号です。 |
static int |
INPUT_METHOD_LAST
インプットメソッドイベント識別子に使う整数の範囲にある最後の番号です。 |
static int |
INPUT_METHOD_TEXT_CHANGED
インプットメソッドテキストが変更されたことを示すイベントタイプです。 |
クラス 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 |
フィールドの詳細 |
public static final int INPUT_METHOD_FIRST
public static final int INPUT_METHOD_TEXT_CHANGED
public static final int CARET_POSITION_CHANGED
public static final int INPUT_METHOD_LAST
コンストラクタの詳細 |
public InputMethodEvent(Component source, int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)
キャレットと visiblePosition のオフセットは、現在の変換テキストに関連します。この場合の変換テキストは、イベントが INPUT_METHOD_TEXT_CHANGED
イベントの場合は、text
内の変換テキスト、それ以外の場合は、先行する INPUT_METHOD_TEXT_CHANGED
イベントの text
内の変換テキストになります。
source
- イベントの発生元オブジェクトid
- イベントのタイプtext
- 確定テキストと変換テキストを合わせたもの。確定テキストが優先される。イベントタイプが CARET_POSITION_CHANGED
の場合は null
、INPUT_METHOD_TEXT_CHANGED
イベントの場合は、確定テキストまたは変換テキストがないときは nullcommittedCharacterCount
- テキスト内の確定された文字の数caret
- キャレット (挿入ポイント)。現在の変換テキストにキャレットがない場合は nullvisiblePosition
- 優先して可視にすべき位置。現在の変換テキスト内に、可視にすべき位置についての指定がない場合は nullIllegalArgumentException
- id
が INPUT_METHOD_FIRST
..INPUT_METHOD_LAST
の範囲にない場合、id
が CARET_POSITION_CHANGED
で text
が null でない場合、または committedCharacterCount
が 0
..(text.getEndIndex() - text.getBeginIndex())
の範囲にない場合public InputMethodEvent(Component source, int id, TextHitInfo caret, TextHitInfo visiblePosition)
キャレットと visiblePosition のオフセットは、現在の変換テキストに対する相対値です。この場合の変換テキストは、イベントが CARET_POSITION_CHANGED
イベントとして構築された場合、先行する INPUT_METHOD_TEXT_CHANGED
イベントの text
内の変換テキストになります。INPUT_METHOD_TEXT_CHANGED
イベントにテキストがなかった場合、キャレットと visiblePosition は null でなければなりません。
source
- イベントの発生元オブジェクトid
- イベントのタイプcaret
- キャレット (挿入ポイント)。現在の変換テキストにキャレットがない場合は nullvisiblePosition
- 優先して可視にすべき位置。現在の変換テキスト内に、可視にすべき位置についての指定がない場合は nullメソッドの詳細 |
public AttributedCharacterIterator getText()
getCommittedCharacterCount() - 1
までの文字が確定されたテキストで、残りの文字が変換テキストです。public int getCommittedCharacterCount()
public TextHitInfo getCaret()
キャレットのオフセットは、現在の変換テキストに対する相対値です。この場合の変換テキストは、イベントが INPUT_METHOD_TEXT_CHANGED
の場合は getText() 内の変換テキスト、それ以外の場合は先行する INPUT_METHOD_TEXT_CHANGED
イベントの getText() 内の変換テキストになります。
public TextHitInfo getVisiblePosition()
可視の位置のオフセットは、現在の変換テキストに関連します。つまり、これが INPUT_METHOD_TEXT_CHANGED
イベントである場合、getText() 内の変換テキストです。それ以外の場合は、先行する INPUT_METHOD_TEXT_CHANGED
イベントの getText() 内の変換テキストです。
public void consume()
AWTEvent
内の consume
public boolean isConsumed()
AWTEvent
内の isConsumed
consume()
public String paramString()
AWTEvent
内の paramString
|
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.