クラス LWTextComponent

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

直系の既知のサブクラス:

ActiveClient

public class LWTextComponent

extends Component

implements KeyListener, FocusListener

非常に単純な軽量テキスト編集コンポーネントを実装します。これにより、ユーザーはキーボードを使って 1 行のテキストを編集できます。認識される特殊文字は、バックスペースのみです。 その他の文字はすべてテキストに追加されます。選択はサポートされていないため、単純なキャレットだけで挿入ポイントが示されます。また、コンポーネントでは、編集可能なテキスト行の上にコンポーネント名が表示され、太さによってコンポーネントにフォーカスがあるかどうかを示す黒のフ レームが描画されます。

入力を有効または無効にする場合は、インプットメソッドによってコンポーネントを初期化することができます。それ以外で、インプットメソッドはサポートされません。 そのため、インプットメソッドの相互作用が発生する場合は、別の変換ウィンドウで行われます。ただし、コンポーネントは完全なインプットメソッドのサポートによって簡単に拡張されるように設計されています。コンポーネントは、「表示されるテキスト」と「確定されたテキスト」を区別します。 これらは同じものですが、オンザスポット入力をサポートするサブクラス では、表示されるテキストは確定されたテキストと変換されたテキストの組み合わせになります。また、コンポーネントはTextLayout を使用してテキストを描画するため、インプットメソッドの強調表示を処理する場合に簡単に拡張できます。

関連項目:

直列化された形式

クラス java.awt.Component から継承されるフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

コンストラクタの概要

LWTextComponent(String name, boolean enableInputMethods)
LWTextComponent を生成します。

メソッドの概要

void	focusGained(FocusEvent event)+ コンポーネントの太枠とキャレットの描画を有効にします。
void	focusLost(FocusEvent event) コンポーネントの太枠とキャレットの描画を無効にします。
TextHitInfo	getCaret() 現在のキャレット (挿入ポイント) を示すテキストヒット情報を返します。
Rectangle	getCaretRectangle() 幅 0 のキャレットの矩形を返します。
Rectangle	getCaretRectangle(TextHitInfo caret) 指定されたテキストインデックスに対して幅 0 のキャレットの矩形を返します。
AttributedCharacterIterator	getCommittedText() ユーザーが入力および確定したテキストを返します。
AttributedCharacterIterator	getCommittedText(int beginIndex, int endIndex) ユーザーが入力および確定したテキストの部分範囲を返します。
int	getCommittedTextLength() ユーザーが入力および確定したテキストの長さを返します。
AttributedCharacterIterator	getDisplayText() ユーザーが入力したテキストを返します。
TextLayout	getTextLayout() ユーザーが入力したテキストのテキストレイアウトを返します。
Point	getTextOrigin() テキストの属性の起点を返します。
void	insertCharacter(char c) 指定された文字をテキストの最後に挿入します。
void	invalidateTextLayout() キャッシュされたテキストレイアウトを無効にします。
void	keyPressed(KeyEvent event) キー挿下イベントを無視します。
void	keyReleased(KeyEvent event) キー解放イベントを無視します。
void	keyTyped(KeyEvent event) キー入力イベントを処理します。
void	paint(Graphics g) コンポーネントを描画します。
void	setFontSize(int size)

クラス 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, getInputMethodRequests, 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

コンストラクタの詳細

LWTextComponent

public LWTextComponent(String name,
                       boolean enableInputMethods)

LWTextComponent を生成します。

パラメータ:

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

enableInputMethods - このコンポーネントに対してインプットメソッドを有効にするかどうか

メソッドの詳細

setFontSize

public void setFontSize(int size)

paint

public void paint(Graphics g)

コンポーネントを描画します。描画される項目は次のとおりです。

• コンポーネントのバックグラウンド
• 枠、コンポーネントにフォーカスがある場合は、太い枠
• コンポーネントの名前
• ユーザーが入力したテキスト
• コンポーネントにフォーカスがある場合は、キャレット

オーバーライド:

クラス Component の paint

getCommittedText

public AttributedCharacterIterator getCommittedText()

ユーザーが入力および確定したテキストを返します。このコンポーネントはオンザスポット入力をサポートしないため、変換テキストはありません。 このため、入力されたすべてのテキストが確定されます。

戻り値:

ユーザーが入力して確定したテキストの AttributedCharacterIterator

getCommittedText

public AttributedCharacterIterator getCommittedText(int beginIndex,
                                                    int endIndex)

ユーザーが入力および確定したテキストの部分範囲を返します。このコンポーネントはオンザスポット入力をサポートしないため、変換テキストはありません。 このため、入力されたすべてのテキストが確定されます。

パラメータ:

beginIndex - 部分範囲の最初の文字のインデックス

endIndex - 部分範囲以降の文字のインデックス

戻り値:

ユーザーが入力して確定したテキストの部分範囲の AttributedCharacterIterator

getCommittedTextLength

public int getCommittedTextLength()

ユーザーが入力および確定したテキストの長さを返します。このコンポーネントはオンザスポット入力をサポートしないため、変換テキストはありません。 このため、入力されたすべてのテキストが確定されます。

戻り値:

ユーザーが入力して確定したテキストの長さ

getDisplayText

public AttributedCharacterIterator getDisplayText()

ユーザーが入力したテキストを返します。TextLayout では、各文字のフォントを定義する必要があるため、デフォルトのフォントがテキスト全体に適用されます。変換テキストを含めるには、オンザスポット入力をサポートするサブクラスがこのメソッドをオーバーライドする必要があります。

戻り値:

ユーザーが入力したテキスト

getTextLayout

public TextLayout getTextLayout()

ユーザーが入力したテキストのテキストレイアウトを返します。このテキストレイアウトは、getDisplayText によって返されるテキストから作成されます。テキストレイアウトは、invalidateTextLayout が呼び出されるまでキャッシュされます。

戻り値:

ユーザーが入力したテキストのテキストレイアウト、または null

関連項目:

invalidateTextLayout()、getDisplayText()

invalidateTextLayout

public void invalidateTextLayout()

キャッシュされたテキストレイアウトを無効にします。コンポーネントのテキストが変更されたときに必ず呼び出される必要があります。

関連項目:

getTextLayout()

getTextOrigin

public Point getTextOrigin()

テキストの属性の起点を返します。これは、テキストのベースラインの一番左のポイントです。

戻り値:

テキストの起点

getCaretRectangle

public Rectangle getCaretRectangle()

幅 0 のキャレットの矩形を返します。この矩形は、getCaret. getCaretRectangle returns null iff getCaret does によって返されるキャレットから得られます。 戻り値:

戻り値:

キャレットの矩形、または null

関連項目:

getCaret()

getCaretRectangle

public Rectangle getCaretRectangle(TextHitInfo caret)

指定されたテキストインデックスに対して幅 0 のキャレットの矩形を返します。これは、getTextLayout によって返されるテキストレイアウトに基づいて計算されます。 このため、このメソッドは表示されるテキスト全体に使用できます。

パラメータ:

caret - キャレットの矩形を計算するテキストインデックス

戻り値:

キャレットの矩形

getCaret

public TextHitInfo getCaret()

現在のキャレット (挿入ポイント) を示すテキストヒット情報を返します。このクラスは、ユーザーが入力したテキストの最後に常にキャレットを返します。サブクラスは、別のキャレットまたは null を返す場合があります。

戻り値:

キャレット、または null

insertCharacter

public void insertCharacter(char c)

指定された文字をテキストの最後に挿入します。

パラメータ:

c - 挿入する文字

keyTyped

public void keyTyped(KeyEvent event)

キー入力イベントを処理します。文字がバックスペースの場合は、ユーザーが入力したテキストから最後の文字が削除されます。それ以外の場合は、文字がテキストに追加され、テキストが再描画されます。

定義:

インタフェース KeyListener の keyTyped

keyPressed

public void keyPressed(KeyEvent event)

キー挿下イベントを無視します。

定義:

インタフェース KeyListener の keyPressed

keyReleased

public void keyReleased(KeyEvent event)

キー解放イベントを無視します。

定義:

インタフェース KeyListener の keyReleased

focusGained

public void focusGained(FocusEvent event)

コンポーネントの太枠とキャレットの描画を有効にします。

定義:

インタフェース FocusListener の focusGained

focusLost

public void focusLost(FocusEvent event)

コンポーネントの太枠とキャレットの描画を無効にします。

定義:

インタフェース FocusListener の focusLost クラス