public class InputMethodEvent extends AWTEvent
インプット・メソッド・イベントに含まれているテキストは、確定テキストと構成テキストの2つの部分から構成されています。どちらの部分も空の場合があります。2つの部分はともに、直前のイベントで送られた未確定の構成テキスト、または現在選択されている確定テキストを置き換えます。確定テキストはテキスト・コンポーネントの永続データに統合されるはずで、再度送信されることはありません。構成テキストは、ユーザーの編集オペレーションを反映するための変更によって、繰返し送信できます。確定テキストは構成テキストよりも常に優先されます。
修飾子と型 | フィールドと説明 |
---|---|
static int |
CARET_POSITION_CHANGED
インプット・メソッド・テキストで挿入ポイントが変更されたことを示すイベント・タイプです。
|
static int |
INPUT_METHOD_FIRST
インプット・メソッド・イベントID範囲の最初の整数IDをマークします。
|
static int |
INPUT_METHOD_LAST
インプット・メソッド・イベントID範囲の最後の整数IDをマークします
|
static int |
INPUT_METHOD_TEXT_CHANGED
インプット・メソッド・テキストが変更されたことを示すイベント・タイプです。
|
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
source
コンストラクタと説明 |
---|
InputMethodEvent(Component source, int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)
指定されたソース・コンポーネント、型、text、caret、およびvisiblePositionで、
InputMethodEvent を構築します。 |
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 を構築します。 |
修飾子と型 | メソッドと説明 |
---|---|
void |
consume()
このイベントを消費して、発生させたソースによりデフォルトの方法で処理されないようにします。
|
TextHitInfo |
getCaret()
キャレットを取得します。
|
int |
getCommittedCharacterCount()
テキスト内の確定文字数を取得します。
|
AttributedCharacterIterator |
getText()
結合された確定および構成テキストを取得します。
|
TextHitInfo |
getVisiblePosition()
もっとも重要な可視にする位置を取得します。
|
long |
getWhen()
このイベントが発生した時点のタイムスタンプを返します。
|
boolean |
isConsumed()
このイベントが消費されたかどうかを返します。
|
String |
paramString()
このイベントを特定するパラメータ文字列を返します。
|
getSource
@Native public static final int INPUT_METHOD_FIRST
@Native public static final int INPUT_METHOD_TEXT_CHANGED
@Native public static final int CARET_POSITION_CHANGED
public InputMethodEvent(Component source, int id, long when, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo 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である場合public InputMethodEvent(Component source, int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo 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である場合public InputMethodEvent(Component source, int id, TextHitInfo caret, TextHitInfo 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である場合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()
public boolean isConsumed()
isConsumed
、クラス: AWTEvent
consume()
public long getWhen()
public String paramString()
paramString
、クラス: AWTEvent
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2016, Oracle and/or its affiliates. All rights reserved.Use is subject to license termsDocumentation Redistribution Policyも参照してください。