クラス ActiveClient

java.lang.Object
  |
  +--java.awt.Component
        |
        +--LWTextComponent
              |
              +--ActiveClient

public class ActiveClient

extends LWTextComponent

implements InputMethodListener, InputMethodRequests

オンザスポットテキスト入力を実装します。インプットメソッドともっとも密接に統合された連携の方式です。このクラスは、Input Method Framework のアクティブクライアントです。つまり、Input Method Framework の API をアクティブに使って、統合を実現します。

このクラスは、Input Method Framework の 2 つのクライアントインタフェース InputMethodListener と InputMethodRequests を直接実装します。これは必須ではありません。特に、クラスライブラリの中など、インタフェースの公開性が重要である場合は、これら 2 つのインタフェースの実装を個別のクラスに隠した方がよい場合があります。

関連項目:

直列化された形式

クラス java.awt.Component から継承したフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

コンストラクタの概要

ActiveClient(String name)
ActiveClient を生成します。

メソッドの概要

AttributedCharacterIterator	cancelLatestCommittedText(AttributedCharacterIterator.Attribute[] attributes) この単純なテキストコンポーネントでは、「確定取り消し」機能がサポートされていないことを示す null を返します。
void	caretPositionChanged(InputMethodEvent event) 変換テキスト内のキャレットに対する変更を処理します。
TextHitInfo	getCaret() 現在のキャレット (挿入ポイント) を示すテキストヒット情報を返します。
AttributedCharacterIterator	getCommittedText(int beginIndex, int endIndex, AttributedCharacterIterator.Attribute[] attributes) 未確定テキスト以外の、テキスト編集コンポーネントに含まれるテキストおよび属性の全体に、アクセスする反復子を取得します。
AttributedCharacterIterator	getDisplayText() ユーザが入力したテキストを返します。
InputMethodRequests	getInputMethodRequests() this を返すことで、ActiveClient の getInputMethodRequests を実装します。
int	getInsertPositionOffset() テキスト編集コンポーネントに含まれる確定テキスト内の挿入位置のオフセットを取得します。
TextHitInfo	getLocationOffset(int x, int y) 指定された画面上の絶対座標 x と y とに対応する変換テキスト内のオフセットを取得します。
AttributedCharacterIterator	getSelectedText(AttributedCharacterIterator.Attribute[] attributes) テキスト編集コンポーネントから、現在選択されているテキストを取得します。
Rectangle	getTextLocation(TextHitInfo offset) 現在の変換テキスト内の指定されたオフセットの場所、または確定テキスト内の選択部分の場所を取得します。
void	inputMethodTextChanged(InputMethodEvent event) インプットメソッドを使って入力されたテキストへの変更を処理します。

クラス LWTextComponent から継承したメソッド

focusGained, focusLost, getCaretRectangle, getCaretRectangle, getCommittedText, getCommittedText, getCommittedTextLength, getTextLayout, getTextOrigin, insertCharacter, invalidateTextLayout, keyPressed, keyReleased, keyTyped, paint

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputContext, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getName, getParent, getPeer, getPreferredSize, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, remove, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFont, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, update, validate

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

ActiveClient

public ActiveClient(String name)

ActiveClient を生成します。ActiveClient のインスタンスでは、インプットメソッドが常に使用可能になります。

パラメータ:

name - テキストの上部に表示されるコンポーネント名

メソッドの詳細

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()

this を返すことで、ActiveClient の getInputMethodRequests を実装します。

戻り値:

this

オーバーライド:

クラス Component 内の getInputMethodRequests

getDisplayText

public AttributedCharacterIterator getDisplayText()

ユーザが入力したテキストを返します。このオーバーライドは、確定テキストと変換テキストを連結したものを返します。

オーバーライド:

クラス LWTextComponent 内の getDisplayText

getCaret

public TextHitInfo getCaret()

現在のキャレット (挿入ポイント) を示すテキストヒット情報を返します。このオーバーライドは、変換テキストが存在している間は、インプットメソッドから提供されるキャレットを返します。変換テキストが存在していない場合は、確定テキストの末尾にあるキャレットを返します。インプットメソッドからは、null のキャレットが提供される場合があります。

オーバーライド:

クラス LWTextComponent 内の getCaret

inputMethodTextChanged

public void inputMethodTextChanged(InputMethodEvent event)

インプットメソッドを使って入力されたテキストへの変更を処理します。イベントに含まれる確定テキストは、テキストコンポーネントの確定テキストに追加されます。イベントに含まれる変換テキストは、テキストコンポーネント内の既存の変換テキストをなんであれ置き換えます。変換テキストがある場合、イベントで定義されているキャレットは保存されて、getCaret の呼び出しで返されます。コンポーネントは再描画されます。

この単純なコンポーネントでは、インプットメソッドの強調表示属性だけが保持されます。より高機能のコンポーネントでは、言語、読み、インプットメソッドセグメントなど、ほかの属性も保持しなければならない場合があります。

定義:

インタフェース InputMethodListener 内の inputMethodTextChanged

caretPositionChanged

public void caretPositionChanged(InputMethodEvent event)

変換テキスト内のキャレットに対する変更を処理します。変換テキストがある場合、イベントで定義されているキャレットは保存されて、getCaret の呼び出しで返されます。コンポーネントは再描画されます。

定義:

インタフェース InputMethodListener 内の caretPositionChanged

getTextLocation

public Rectangle getTextLocation(TextHitInfo offset)

現在の変換テキスト内の指定されたオフセットの場所、または確定テキスト内の選択部分の場所を取得します。

定義:

インタフェース InputMethodRequests 内の getTextLocation

getLocationOffset

public TextHitInfo getLocationOffset(int x,
                                     int y)

指定された画面上の絶対座標 x と y とに対応する変換テキスト内のオフセットを取得します。

定義:

インタフェース InputMethodRequests 内の getLocationOffset

getInsertPositionOffset

public int getInsertPositionOffset()

テキスト編集コンポーネントに含まれる確定テキスト内の挿入位置のオフセットを取得します。この単純なコンポーネントでは、挿入位置は常に確定テキストの末尾になります。

定義:

インタフェース InputMethodRequests 内の getInsertPositionOffset

getCommittedText

public AttributedCharacterIterator getCommittedText(int beginIndex,
                                                    int endIndex,
                                                    AttributedCharacterIterator.Attribute[] attributes)

未確定テキスト以外の、テキスト編集コンポーネントに含まれるテキストおよび属性の全体に、アクセスする反復子を取得します。

定義:

インタフェース InputMethodRequests 内の getCommittedText

cancelLatestCommittedText

public AttributedCharacterIterator cancelLatestCommittedText(AttributedCharacterIterator.Attribute[] attributes)

この単純なテキストコンポーネントでは、「確定取り消し」機能がサポートされていないことを示す null を返します。

定義:

インタフェース InputMethodRequests 内の cancelLatestCommittedText

getSelectedText

public AttributedCharacterIterator getSelectedText(AttributedCharacterIterator.Attribute[] attributes)

テキスト編集コンポーネントから、現在選択されているテキストを取得します。この単純なテキストコンポーネントでは選択機能をサポートしていないので、結果は常に空のテキストに対する反復子になります。

定義:

インタフェース InputMethodRequests 内の getSelectedText