JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.text
クラス JTextComponent

java.lang.Object
  上位を拡張 java.awt.Component
      上位を拡張 java.awt.Container
          上位を拡張 javax.swing.JComponent
              上位を拡張 javax.swing.text.JTextComponent
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible, Scrollable
直系の既知のサブクラス:
JEditorPane, JTextArea, JTextField

public abstract class JTextComponent
extends JComponent
implements Scrollable, Accessible

JTextComponent は swing テキストコンポーネントの基底クラスです。このクラスは、道理にかなった範囲で java.awt.TextComponent クラスとの互換性維持を試みます。また、他のサービスも提供されているため、柔軟性を持たせることができます (プラグイン可能な UI と Bean のサポートを除く)。このクラスの機能の使用方法の詳細は、「The Java Tutorial」の「General Rules for Using Text Components」セクションを参照してください。

コマンド
テキストコンポーネントは、コンポーネントの操作に使用するコマンドを提供します。これは、コンポーネントがその機能を表現する基本的な方法です。これらは TextAction の実装を使用して、swing Action インタフェースの形で表現されます。テキストコンポーネントがサポートするコマンドセットは、getActions() メソッドで確認できます。これらのアクションは、ボタンなどから発生するキーイベントに割り当てることが可能です。

テキスト入力
テキストコンポーネントは、キーマップとインプットメソッドのフレームワークを使用して柔軟で国際化されたテキスト入力をサポートしています。また、AWT リスナーモデルとの互換性も備えています。

Keymap を利用すると、アプリケーションがキーストロークをアクションにバインドできるようになります。キーマップを複数のテキストコンポーネントで共有するために、TextAction を拡張するアクションを使用できます。TextAction は最後にフォーカスを保持した (それゆえアクションの対象となる) JTextComponent を判別できます。この場合、アクションに送信される ActionEvent には、ターゲットテキストコンポーネントがソースとして含まれません。

インプットメソッドフレームワークで、テキストコンポーネントをインプットメソッドと結び付けることができます。このインプットメソッドは、キーのかなり少ないキーボードを使用して何千もの異なる文字をユーザが入力できるようにするイベントを前処理する個々のソフトウェアコンポーネントです。JTextComponent は、フレームワークの「アクティブクライアント」であるため、インプットメソッドとやりとりするための適切なユーザインタフェースを実装します。結果的に、キーイベントの中にはインプットメソッドにより処理されるため、テキストコンポーネントに到達しないものがあります。また、テキスト入力の中には、キーイベントとしてではなく InputMethodEvent の中の確定テキストとして、テキストコンポーネントに到達するものもあります。完全なテキスト入力とは、keyTyped キーイベントの文字と、インプットメソッドイベントの確定テキストとの組み合わせです。

AWT リスナーモデルでは、アプリケーションを使用してイベントをアクションにバインドするためにイベントリスナーをコンポーネントと結び付けることができます。Swing では、リスナーではなくキーマップを使用することが推奨されていますが、イベントを消費することでそのイベントを横取りする機会をリスナーに与えることにより、リスナーとの互換性を維持しています。

キーボードイベントとインプットメソッドイベントは、次の工程で処理されます。各工程ではイベントを使用します。

工程

KeyEvent

InputMethodEvent

1. インプットメソッド (ここで生成される)
2. フォーカスマネージャ
3. 登録済みのキーリスナー 登録済みのインプットメソッドリスナー
4. JTextComponent で処理するインプットメソッド
5. 現在のキーマップを使用して処理するキーマップ
6. JComponent で処理するキーボード (アクセラレータ、コンポーネントナビゲーションなど)

キーイベントを待機しているにもかかわらず、インプットメソッドイベントを認識しないアプリケーションとの互換性を保つため、工程 4 で処理するインプットメソッドでは、インプットメソッドイベントを処理しないコンポーネントのために互換モードを提供します。これらのコンポーネントの場合、確定テキストは keyTyped キーイベントに変換されてから、インプットメソッドイベントパイプラインではなく、工程 3 で開始するキーイベントパイプラインで処理されます。

コンポーネントはデフォルトで、すべての JextComponent のインスタンスによりデフォルトキーマップとして共有されるキーマップ (DEFAULT_KEYMAP) を作成します。通常、Look & Feel の実装は、デフォルトのキーマップに解決する別のキーマップをインストールして、デフォルトのキーマップを、別のキーマップにはないキー割り当てに対応させます。以下に、最小の割り当てを示します。

  • エディタにプリント可能キーのコンテンツを挿入する
  • バックスペースキーと Del キーでコンテンツを削除する
  • 順方向と逆方向のキャレット移動

モデル/ビュー分割
テキストコンポーネントはモデル/ビュー分割を持ちます。テキストコンポーネントは、モデル、ビュー、コントローラを表すのに使うオブジェクトをまとめます。テキストドキュメントモデルは、モデルのオブザーバとして動作するほかのビューによって共有されます (たとえば、ドキュメントを複数のコンポーネントによって共有できる)。

コントローラ、ドキュメント、イベント、および ViewFactory 間のやりとりを示す図

このモデルは Document インタフェースによって定義されます。これは、編集時に変更を追跡する柔軟なテキスト記憶機構を提供するためのもので、より高度なモデルに拡張できます。モデルインタフェースは、SGML が提供する式の機能、つまり多様なコンテンツを表現するのに使うシステムを取り込むためのものです。ドキュメントに加える各修正は、ビューを最新のモデルに同期できるようにする DocumentEvent という形式で変更の詳細な通知がすべてのオブザーバに送られます。このイベントは、DocumentListener インタフェースを実装して監視中のモデルに配信対象を登録したオブザーバに送られます。

位置情報
ビュー内のテキスト位置を判定する機能が提供されます。この情報を判定するために、modelToView(int)viewToModel(java.awt.Point) の 2 つのメソッドが用意されています。

元に戻す/再実行のサポート
編集履歴機構がサポートされているため、「元に戻す/再実行」の操作を行うことができます。テキストコンポーネントはそれ自体ではデフォルトで履歴バッファを提供しませんが、履歴バッファと組み合わせて使うと、「元に戻す/再実行」をサポートする UndoableEdit レコードを提供します。そのサポートは Document モデルにより提供されます。このモデルにより、UndoableEditListener の実装の追加が可能になります。

スレッドセーフ
Swing テキストコンポーネントはスレッドセーフな操作をサポートします。テキストコンポーネントは高度な構成機能を持つため、提供される保護機能を使用しないこともできます。保護機能は主にモデルにより考え出されたもので、AbstractDocument のマニュアルでは提供される保護の前提条件を説明しています。非同期で安全に呼び出せるメソッドには、コメントが付けられています。

改行
改行の処理方法については、DefaultEditorKit を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降、すべての JavaBeans の長期間の運用サポートは、java.beans パッケージに追加されています。詳細は、XMLEncoder を参照してください。

関連項目:
Document, DocumentEvent, DocumentListener, Caret, CaretEvent, CaretListener, TextUI, View, ViewFactory

入れ子のクラスの概要
 class JTextComponent.AccessibleJTextComponent
          このクラスは JTextComponent クラス用のユーザ補助機能のサポートを実装しています。
static class JTextComponent.KeyBinding
          キーバインド作成用のレコードを割り当てます。
 
クラス javax.swing.JComponent から継承された入れ子のクラス/インタフェース
JComponent.AccessibleJComponent
 
クラス java.awt.Container から継承された入れ子のクラス/インタフェース
Container.AccessibleAWTContainer
 
クラス java.awt.Component から継承された入れ子のクラス/インタフェース
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
フィールドの概要
static String DEFAULT_KEYMAP
          異なるキーマップセットを持っていない限り、全 JTextComponent インスタンスで共有されるデフォルトのキーマップです。
static String FOCUS_ACCELERATOR_KEY
          フォーカスアクセラレータのバウンドプロパティ名です。
 
クラス javax.swing.JComponent から継承されたフィールド
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
クラス java.awt.Component から継承されたフィールド
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
インタフェース java.awt.image.ImageObserver から継承されたフィールド
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
コンストラクタの概要
JTextComponent()
          新しい JTextComponent を作成します。
 
メソッドの概要
 void addCaretListener(CaretListener listener)
          変更を通知するためのキャレットリスナーをキャレットに追加します。
 void addInputMethodListener(InputMethodListener l)
          このコンポーネントからインプットメソッドイベントを受け取るために、指定されたインプットメソッドリスナーを追加します。
static Keymap addKeymap(String nm, Keymap parent)
          新しいキーマップをキーマップ階層に追加します。
 void copy()
          関連するテキストモデル内の現在選択されている領域をシステムクリップボードに転送して、テキストモデル内のコンテンツはそのまま残します。
 void cut()
          関連するテキストモデル内の現在選択されている領域をシステムクリップボードに転送して、モデルからコンテンツを削除します。
protected  void fireCaretUpdate(CaretEvent e)
          通知の配信対象をこのイベントタイプで登録したすべてのリスナーに通知します。
 AccessibleContext getAccessibleContext()
          この JTextComponent に関連した AccessibleContext を取得します。
 Action[] getActions()
          エディタのコマンドリストを返します。
 Caret getCaret()
          ビューでテキスト指向ナビゲーションを可能にするキャレットを取り出します。
 Color getCaretColor()
          キャレットを描画するのに使う現在の色を取り出します。
 CaretListener[] getCaretListeners()
          このテキストコンポーネントに登録された、すべてのキャレットリスナーからなる配列を返します。
 int getCaretPosition()
          テキストコンポーネントのテキスト挿入キャレットの位置を返します。
 Color getDisabledTextColor()
          選択したテキストを描画するのに使う現在の色を取り出します。
 Document getDocument()
          エディタに関連したモデルを取り出します。
 boolean getDragEnabled()
          dragEnabled プロパティを取得します。
 char getFocusAccelerator()
          受信側テキストコンポーネントにフォーカスを取得させるキーアクセラレータを返します。
 Highlighter getHighlighter()
          ハイライトをつけるのに使用されるオブジェクトを取り出します。
 InputMethodRequests getInputMethodRequests()
          このコンポーネントのインプットメソッドからの要求をサポートするインプットメソッド要求ハンドラを返します。
 Keymap getKeymap()
          このテキストコンポーネントで現在アクティブなキーマップを取り出します。
static Keymap getKeymap(String nm)
          それまでにドキュメントに追加されていた名前付きキーマップを取得します。
 Insets getMargin()
          テキストコンポーネントの境界とそのテキストの間のマージンを返します。
 NavigationFilter getNavigationFilter()
          NavigationFilter を返します。
 Dimension getPreferredScrollableViewportSize()
          ビューコンポーネントのビューポートの適切なサイズを返します。
 int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
          論理行または論理列を表示するコンポーネントは、orientation の値によって、1 ブロック分の行または列を完全にエクスポーズするスクロール増分値を計算します。
 boolean getScrollableTracksViewportHeight()
          ビューポートでこの Scrollable の高さを常にビューポートの高さに合わせる場合に、true を返します。
 boolean getScrollableTracksViewportWidth()
          ビューポートが、常にこの Scrollable の幅を強制的にビューポートの幅に一致させようとする場合は、true を返します。
 int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
          論理行または論理列を表示するコンポーネントは、orientation の値によって、新しい 1 行または 1 列を完全にエクスポーズするスクロール増分値を計算します。
 String getSelectedText()
          この TextComponent に格納された選択されているテキストを返します。
 Color getSelectedTextColor()
          選択したテキストを描画するのに使う現在の色を取り出します。
 Color getSelectionColor()
          選択領域を描画するのに使う現在の色を取り出します。
 int getSelectionEnd()
          選択したテキストの末尾位置を返します。
 int getSelectionStart()
          選択したテキストの開始位置を返します。
 String getText()
          この TextComponent に格納されたテキストを返します。
 String getText(int offs, int len)
          コンポーネントが表すテキストの一部を取り出します。
 String getToolTipText(MouseEvent event)
          event のツールヒントとして使用される文字列を返します。
 TextUI getUI()
          このテキスト指向エディタのユーザインタフェースファクトリを取り出します。
 boolean isEditable()
          この TextComponent が編集可能かどうかを示す boolean 型を返します。
static void loadKeymap(Keymap map, JTextComponent.KeyBinding[] bindings, Action[] actions)
           キーマップに多数の割り当てをロードします。
 Rectangle modelToView(int pos)
          モデル内の指定された位置を、ビュー座標系内の場所に変換します。
 void moveCaretPosition(int pos)
          キャレットを新しい位置に移動して、setCaretPosition が前回呼び出されたときに定義されたマークは残しておきます。
protected  String paramString()
          この JTextComponent の文字列表現を返します。
 void paste()
          システムクリップボードのコンテンツを関連するテキストモデルに転送します。
protected  void processInputMethodEvent(InputMethodEvent e)
          このコンポーネントで発生するインプットメソッドイベントを、登録されているすべての InputMethodListener オブジェクトにディスパッチすることによって処理します。
 void read(Reader in, Object desc)
          ストリームから初期化します。
 void removeCaretListener(CaretListener listener)
          キャレットリスナーを削除します。
static Keymap removeKeymap(String nm)
          それまでにドキュメントに追加されていた名前付きキーマップを削除します。
 void removeNotify()
          このコンポーネントに親コンポーネントがなくなったことを、このコンポーネントに通知します。
 void replaceSelection(String content)
          現在選択されているコンテンツを、渡された文字列が示す新しいコンテンツで置き換えます。
 void select(int selectionStart, int selectionEnd)
          指定された始点と終点の間にあるテキストを選択します。
 void selectAll()
          TextComponent 内のすべてのテキストを選択します。
 void setCaret(Caret c)
          使用するキャレットを設定します。
 void setCaretColor(Color c)
          キャレットを描画するのに使う現在の色を設定します。
 void setCaretPosition(int position)
          TextComponent のテキスト挿入キャレットの位置を設定します。
 void setComponentOrientation(ComponentOrientation o)
          このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を設定します。
 void setDisabledTextColor(Color c)
          無効にしたテキストを描画するのに使う現在の色を設定します。
 void setDocument(Document doc)
          エディタをテキストドキュメントに関連付けます。
 void setDragEnabled(boolean b)
          dragEnabled プロパティを設定します。
 void setEditable(boolean b)
          この TextComponent が編集可能かどうかを設定します。
 void setFocusAccelerator(char aKey)
          受信側テキストコンポーネントにフォーカスを取得させるキーアクセラレータを設定します。
 void setHighlighter(Highlighter h)
          使用するハイライタを設定します。
 void setKeymap(Keymap map)
          イベントをアクションに割り当てるのに使うキーマップを設定します。
 void setMargin(Insets m)
          テキストコンポーネントの境界とそのテキストの間のマージン空白を設定します。
 void setNavigationFilter(NavigationFilter filter)
          NavigationFilter を設定します。
 void setSelectedTextColor(Color c)
          選択したテキストを描画するのに使う現在の色を設定します。
 void setSelectionColor(Color c)
          選択領域を描画するのに使う現在の色を設定します。
 void setSelectionEnd(int selectionEnd)
          選択領域の末尾を、指定された位置に設定します。
 void setSelectionStart(int selectionStart)
          選択開始を、指定された位置に設定します。
 void setText(String t)
          この TextComponent のテキストに、指定されたテキストを設定します。
 void setUI(TextUI ui)
          このテキスト指向エディタのユーザインタフェースファクトリを設定します。
 void updateUI()
          プラグイン可能な UI を再ロードします。
 int viewToModel(Point pt)
          ビュー座標体系内の指定された場所を、モデル内の最も近い位置に変換します。
 void write(Writer out)
          モデルのコンテンツを、指定されたストリームに格納します。
 
クラス javax.swing.JComponent から継承されたメソッド
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
クラス java.awt.Container から継承されたメソッド
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
クラス java.awt.Component から継承されたメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

FOCUS_ACCELERATOR_KEY

public static final String FOCUS_ACCELERATOR_KEY
フォーカスアクセラレータのバウンドプロパティ名です。

関連項目:
定数フィールド値

DEFAULT_KEYMAP

public static final String DEFAULT_KEYMAP
異なるキーマップセットを持っていない限り、全 JTextComponent インスタンスで共有されるデフォルトのキーマップです。

関連項目:
定数フィールド値
コンストラクタの詳細

JTextComponent

public JTextComponent()
新しい JTextComponent を作成します。キャレットイベントのリスナーが確立され、プラグイン可能な UI がインストールされます。コンポーネントは編集可能とマークされます。配置はテキストのビューサブシステムによって管理されるので、レイアウトマネージャは使用されません。ドキュメントモデルは null に設定されます。

メソッドの詳細

getUI

public TextUI getUI()
このテキスト指向エディタのユーザインタフェースファクトリを取り出します。

戻り値:
ファクトリ

setUI

public void setUI(TextUI ui)
このテキスト指向エディタのユーザインタフェースファクトリを設定します。

パラメータ:
ui - ファクトリ

updateUI

public void updateUI()
プラグイン可能な UI を再ロードします。新しいインタフェースを取得するのに使うキーは getUIClassID() です。UI のタイプは TextUI です。invalidate は、UI の設定後に呼び出されます。

オーバーライド:
クラス JComponent 内の updateUI
関連項目:
JComponent.setUI(javax.swing.plaf.ComponentUI), UIManager.getLookAndFeel(), UIManager.getUI(javax.swing.JComponent)

addCaretListener

public void addCaretListener(CaretListener listener)
変更を通知するためのキャレットリスナーをキャレットに追加します。

パラメータ:
listener - 追加されるリスナー
関連項目:
CaretEvent

removeCaretListener

public void removeCaretListener(CaretListener listener)
キャレットリスナーを削除します。

パラメータ:
listener - 削除されるリスナー
関連項目:
CaretEvent

getCaretListeners

public CaretListener[] getCaretListeners()
このテキストコンポーネントに登録された、すべてのキャレットリスナーからなる配列を返します。

戻り値:
このコンポーネントの CaretListener すべて。キャレットリスナーが登録されていない場合は空の配列
導入されたバージョン:
1.4
関連項目:
addCaretListener(javax.swing.event.CaretListener), removeCaretListener(javax.swing.event.CaretListener)

fireCaretUpdate

protected void fireCaretUpdate(CaretEvent e)
通知の配信対象をこのイベントタイプで登録したすべてのリスナーに通知します。イベントインスタンスは起動メソッドに渡されたパラメータを使ってあとで作成されます。リスナーリストは降順方式で処理されます。

パラメータ:
e - イベント
関連項目:
EventListenerList

setDocument

public void setDocument(Document doc)
エディタをテキストドキュメントに関連付けます。現在登録されているファクトリを使うと、ドキュメントのビューを構築できます。このドキュメントは、再検証後にエディタによって表示されます。PropertyChange イベント (document) は、各リスナーに通知されます。

パラメータ:
doc - 表示および編集するドキュメント
関連項目:
getDocument()

getDocument

public Document getDocument()
エディタに関連したモデルを取り出します。これは主に、テキストエディタであるために必要な最小限の状態に UI が到達するためのものです。サブクラスは、モデルの実際のタイプを返します。このタイプは通常 Document を拡張したものになります。

戻り値:
モデル

setComponentOrientation

public void setComponentOrientation(ComponentOrientation o)
クラス Component の記述:
このコンポーネント内の要素またはテキストを整列するために使用する、言語に依存する方向を設定します。言語に依存する LayoutManager サブクラスおよび Component サブクラスはこのプロパティを使用してコンポーネントの配置方法および描画方法を決めます。

構築時には、コンポーネントの方向は、明示的に指定されていないことを示す ComponentOrientation.UNKNOWN に設定されます。UNKNOWN の方向の動作は ComponentOrientation.LEFT_TO_RIGHT と同じです。

コンポーネントの方向決定を単独で行う場合はこのメソッドを使用します。コンポーネント階層全体の方向を決定する場合は、applyComponentOrientation を使用します。

オーバーライド:
クラス Component 内の setComponentOrientation
関連項目:
ComponentOrientation

getActions

public Action[] getActions()
エディタのコマンドリストを返します。これは、エディタ自身がサポートするコマンドコレクションで拡張された、プラグイン済み UI によってサポートされるコマンドのリストです。これらは、キーマップ内でのように、イベントへの割り当てに役立ちます。

戻り値:
コマンドリスト

setMargin

public void setMargin(Insets m)
テキストコンポーネントの境界とそのテキストの間のマージン空白を設定します。テキストコンポーネントのデフォルト Border オブジェクトは、この値を使って適切なマージンを作成します。ただし、デフォルト以外の境界が設定されている場合は、Border オブジェクトが適切なマージン空白を作成します。 (それ以外の場合、このプロパティは事実上無視される)。このためコンポーネントの再描画が行われます。PropertyChange イベント (margin) はすべてのリスナーに送られます。

パラメータ:
m - ボーダとテキストの間のマージン

getMargin

public Insets getMargin()
テキストコンポーネントの境界とそのテキストの間のマージンを返します。

戻り値:
マージン

setNavigationFilter

public void setNavigationFilter(NavigationFilter filter)
NavigationFilter を設定します。NavigationFilterDefaultCaret と、カーソルの移動を限定するデフォルトのカーソル移動処理で使用されます。

導入されたバージョン:
1.4

getNavigationFilter

public NavigationFilter getNavigationFilter()
NavigationFilter を返します。NavigationFilterDefaultCaret と、カーソルの移動を限定するデフォルトのカーソル移動処理で使用されます。戻り値の null はカーソルの移動と選択が制限されないことを表します。

戻り値:
NavigationFilter
導入されたバージョン:
1.4

getCaret

public Caret getCaret()
ビューでテキスト指向ナビゲーションを可能にするキャレットを取り出します。

戻り値:
キャレット

setCaret

public void setCaret(Caret c)
使用するキャレットを設定します。デフォルトで、インストールされる UI によって設定されます。これは、必要に応じてカスタムキャレットに変更できます。キャレットを設定すると、PropertyChange イベント (caret) が発生します。

パラメータ:
c - キャレット
関連項目:
getCaret()

getHighlighter

public Highlighter getHighlighter()
ハイライトをつけるのに使用されるオブジェクトを取り出します。

戻り値:
ハイライタ

setHighlighter

public void setHighlighter(Highlighter h)
使用するハイライタを設定します。デフォルトで、インストールされる UI によって設定されます。これは、必要に応じてカスタムハイライタに変更できます。これを無効にするには、ハイライタを null に設定します。新しいハイライタがインストールされると、PropertyChange イベント (highlighter) が発生します。

パラメータ:
h - ハイライタ
関連項目:
getHighlighter()

setKeymap

public void setKeymap(Keymap map)
イベントをアクションに割り当てるのに使うキーマップを設定します。null に設定すると、キーボード入力が事実上無効になります。新しいキーマップをインストールすると、PropertyChange イベント (keymap) が発生します。

パラメータ:
map - キーマップ
関連項目:
getKeymap()

setDragEnabled

public void setDragEnabled(boolean b)
dragEnabled プロパティを設定します。このプロパティは、このコンポーネントの自動ドラッグ処理 (ドラッグ&ドロップの最初の処理) を有効にするために true でなければなりません。transferHandler プロパティは、ドラッグで何でもできるように null 以外の値に設定する必要があります。dragEnabled プロパティのデフォルトの値は false です。

自動ドラッグ処理が有効の場合、ほとんどの Look & Feel は、ユーザが選択のためにマウスボタンを押して、マウスを数ピクセル移動すると常にドラッグ&ドロップ操作が始まります。したがって、このプロパティを true に設定することは、選択の動作に微妙な効果があります。

一部の Look & Feel は自動ドラッグ&ドロップ操作をサポートしない場合があります。これらはこのプロパティを無視します。直接 TransferHandlerexportAsDrag メソッドを呼び出してコンポーネントを変更することにより、このような Look & Feel を操作することができます。

パラメータ:
b - dragEnabled プロパティに設定される値
例外:
HeadlessException - btrue の場合で GraphicsEnvironment.isHeadless()true を返す場合
導入されたバージョン:
1.4
関連項目:
GraphicsEnvironment.isHeadless(), getDragEnabled(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandler

getDragEnabled

public boolean getDragEnabled()
dragEnabled プロパティを取得します。

戻り値:
dragEnabled プロパティの値
導入されたバージョン:
1.4
関連項目:
setDragEnabled(boolean)

getKeymap

public Keymap getKeymap()
このテキストコンポーネントで現在アクティブなキーマップを取り出します。

戻り値:
キーマップ

addKeymap

public static Keymap addKeymap(String nm,
                               Keymap parent)
新しいキーマップをキーマップ階層に追加します。キーマップ割り当ては下から上へ解釈処理されるので、子で指定した属性は親で指定した属性をオーバーライドします。

パラメータ:
nm - キーマップ名 (ドキュメント内の名前付きキーマップのコレクションで一意でなければならない)。キーマップに名前を指定しない場合、名前は null でもかまわない。ただし、名前なしキーマップは名前で取得できないので、返された参照の管理は呼び出し側で行う
parent - 親キーマップ。未指定の割り当てをほかの特定のキーマップで解釈処理する必要がない場合は、null でもかまわない
戻り値:
キーマップ

removeKeymap

public static Keymap removeKeymap(String nm)
それまでにドキュメントに追加されていた名前付きキーマップを削除します。名前が null であるキーマップは、この方法では削除できません。

パラメータ:
nm - 削除するキーマップの名前
戻り値:
削除されたキーマップ

getKeymap

public static Keymap getKeymap(String nm)
それまでにドキュメントに追加されていた名前付きキーマップを取得します。名前が null であるキーマップは扱いません。

パラメータ:
nm - キーマップの名前
戻り値:
キーマップ

loadKeymap

public static void loadKeymap(Keymap map,
                              JTextComponent.KeyBinding[] bindings,
                              Action[] actions)

キーマップに多数の割り当てをロードします。このメソッドを使うと、定義のスタティックテーブルを取得して特定のキーマップにロードできます。次に、いくつかのキーを JtextComponent に関連したカット、コピー、ペーストの各アクションに割り当てる例を示します。



   static final JTextComponent.KeyBinding[] defaultBindings = {
     new JTextComponent.KeyBinding(
       KeyStroke.getKeyStroke(KeyEvent.VK_C, InputEvent.CTRL_MASK),
       DefaultEditorKit.copyAction),
     new JTextComponent.KeyBinding(
       KeyStroke.getKeyStroke(KeyEvent.VK_V, InputEvent.CTRL_MASK),
       DefaultEditorKit.pasteAction),
     new JTextComponent.KeyBinding(
       KeyStroke.getKeyStroke(KeyEvent.VK_X, InputEvent.CTRL_MASK),
       DefaultEditorKit.cutAction),
   };

   JTextComponent c = new JTextPane();
   Keymap k = c.getKeymap();
   JTextComponent.loadKeymap(k, defaultBindings, c.getActions());
 
 
割り当てとアクションのセットは空でもかまいませんが、null にはできません。

パラメータ:
map - キーマップ
bindings - バインディング
actions - アクションのセット

getCaretColor

public Color getCaretColor()
キャレットを描画するのに使う現在の色を取り出します。

戻り値:

setCaretColor

public void setCaretColor(Color c)
キャレットを描画するのに使う現在の色を設定します。これを null に設定すると、効果的にデフォルトの色を復元します。色を設定すると、PropertyChange イベント (caretColor) が発生します。

パラメータ:
c - 色
関連項目:
getCaretColor()

getSelectionColor

public Color getSelectionColor()
選択領域を描画するのに使う現在の色を取り出します。

戻り値:

setSelectionColor

public void setSelectionColor(Color c)
選択領域を描画するのに使う現在の色を設定します。色に null を設定することは、Color.white を設定することと同じです。色を設定すると、PropertyChange イベント (selectionColor) が発生します。

パラメータ:
c - 色
関連項目:
getSelectionColor()

getSelectedTextColor

public Color getSelectedTextColor()
選択したテキストを描画するのに使う現在の色を取り出します。

戻り値:

setSelectedTextColor

public void setSelectedTextColor(Color c)
選択したテキストを描画するのに使う現在の色を設定します。色に null を設定することは、Color.black を設定することと同じです。色を設定すると、PropertyChange イベント (selectedTextColor) が発生します。

パラメータ:
c - 色
関連項目:
getSelectedTextColor()

getDisabledTextColor

public Color getDisabledTextColor()
選択したテキストを描画するのに使う現在の色を取り出します。

戻り値:

setDisabledTextColor

public void setDisabledTextColor(Color c)
無効にしたテキストを描画するのに使う現在の色を設定します。色を設定すると、PropertyChange イベント (disabledTextColor) が発生します。

パラメータ:
c - 色
関連項目:
getDisabledTextColor()

replaceSelection

public void replaceSelection(String content)
現在選択されているコンテンツを、渡された文字列が示す新しいコンテンツで置き換えます。選択領域がない場合は、指定されたテキストの挿入と同等です。置換後のテキストがない場合、現在の選択領域の削除と同等です。

このメソッドは、キーマップアクションに割り当てられるコンテンツを挿入するアクションのデフォルト実装によって使用されます。

このメソッドはスレッドに対して安全ですが、ほとんどの Swing メソッドは違います。詳細は、「Threads and Swing」を参照してください。

パラメータ:
content - 選択範囲を置き換えるコンテンツ

getText

public String getText(int offs,
                      int len)
               throws BadLocationException
コンポーネントが表すテキストの一部を取り出します。長さが 0 の場合は、空の文字列を返します。

パラメータ:
offs - オフセット >= 0
len - 長さ >= 0
戻り値:
テキスト
例外:
BadLocationException - オフセットまたは長さが無効な場合

modelToView

public Rectangle modelToView(int pos)
                      throws BadLocationException
モデル内の指定された位置を、ビュー座標系内の場所に変換します。この変換を計算するために、コンポーネントは正のサイズを持つ必要があります。つまり、コンポーネントのサイズが決定されるまでレイアウトの計算はできません。コンポーネントは可視である必要もペイントされている必要もありません。

パラメータ:
pos - 位置 >= 0
戻り値:
矩形の座標。座標体系での位置を (r.x, r.y) で表現。コンポーネントがまだ正のサイズを持っていない場合は null
例外:
BadLocationException - 指定された位置が、関連するドキュメント内の有効な位置を表さない場合
関連項目:
TextUI.modelToView(javax.swing.text.JTextComponent, int)

viewToModel

public int viewToModel(Point pt)
ビュー座標体系内の指定された場所を、モデル内の最も近い位置に変換します。この変換を計算するために、コンポーネントは正のサイズを持つ必要があります。つまり、コンポーネントのサイズが決定されるまでレイアウトの計算はできません。コンポーネントは可視である必要もペイントされている必要もありません。

パラメータ:
pt - 変換するビュー内の位置
戻り値:
ドキュメントの先頭からのオフセット >= 0。コンポーネントがまだ正のサイズを持っていない場合は -1
関連項目:
TextUI.viewToModel(javax.swing.text.JTextComponent, java.awt.Point)

cut

public void cut()
関連するテキストモデル内の現在選択されている領域をシステムクリップボードに転送して、モデルからコンテンツを削除します。現在の選択領域は取り消されます。選択領域が null の場合には何も行いません。

関連項目:
Toolkit.getSystemClipboard(), Clipboard

copy

public void copy()
関連するテキストモデル内の現在選択されている領域をシステムクリップボードに転送して、テキストモデル内のコンテンツはそのまま残します。現在の選択領域は元のまま残ります。選択領域が null の場合には何も行いません。

関連項目:
Toolkit.getSystemClipboard(), Clipboard

paste

public void paste()
システムクリップボードのコンテンツを関連するテキストモデルに転送します。関連するビュー内に選択領域があるときは、クリップボードのコンテンツで置き換えられます。選択領域がないときは、クリップボードのコンテンツは関連するビュー内の現在の挿入位置の前に挿入されます。クリップボードが空の場合には何も行いません。

関連項目:
replaceSelection(java.lang.String), Toolkit.getSystemClipboard(), Clipboard

moveCaretPosition

public void moveCaretPosition(int pos)
キャレットを新しい位置に移動して、setCaretPosition が前回呼び出されたときに定義されたマークは残しておきます。このメソッドは選択領域を形成します。ドキュメントが null の場合には何も行いません。位置は 0 とコンポーネントテキストの長さとの間でなければならず、そうでない場合は例外がスローされます。

パラメータ:
pos - 位置
例外:
IllegalArgumentException - position に指定した値が 0 未満、またはコンポーネントテキストより長い場合
関連項目:
setCaretPosition(int)

setFocusAccelerator

public void setFocusAccelerator(char aKey)
受信側テキストコンポーネントにフォーカスを取得させるキーアクセラレータを設定します。アクセラレータは、alt キーと指定された文字キーの組み合わせになります (大文字に変換される)。デフォルトでは、フォーカスアクセラレータキーはありません。それまでのキーアクセラレータ設定はすべて破棄されます。「\0」キー設定が登録され、フォーカスアクセラレータをオフに設定する効果を持ちます。新しいキーを設定すると、PropertyChange イベント (FOCUS_ACCELERATOR_KEY) が発生します。

パラメータ:
aKey - キー
関連項目:
getFocusAccelerator()

getFocusAccelerator

public char getFocusAccelerator()
受信側テキストコンポーネントにフォーカスを取得させるキーアクセラレータを返します。設定済みのフォーカスアクセラレータがない場合は、「\0」を返します。

戻り値:
キー

read

public void read(Reader in,
                 Object desc)
          throws IOException
ストリームから初期化します。コンポーネントに適切なタイプのモデルを作成して、モデルをストリームから初期化します。デフォルトで、モデルをプレーンテキストでロードします。モデルのそれまでのコンテンツは破棄されます。

パラメータ:
in - 読み込み元のストリーム
desc - ストリームを記述するオブジェクト。String、File、URL など。ある種のドキュメント (たとえば HTML) は、この情報を利用できる場合がある。null 以外の場合、ドキュメントのプロパティとして追加される
例外:
IOException - 初期化に使われるストリームによってスローされる
関連項目:
EditorKit.createDefaultDocument(), setDocument(javax.swing.text.Document), PlainDocument

write

public void write(Writer out)
           throws IOException
モデルのコンテンツを、指定されたストリームに格納します。デフォルトで、モデルをプレーンテキストで格納します。

パラメータ:
out - 出力ストリーム
例外:
IOException - 入出力エラーが発生した場合

removeNotify

public void removeNotify()
クラス JComponent の記述:
このコンポーネントに親コンポーネントがなくなったことを、このコンポーネントに通知します。このメソッドが呼び出されると、親コンポーネントのチェーンに設定された KeyboardAction が削除されます。

オーバーライド:
クラス JComponent 内の removeNotify
関連項目:
JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

setCaretPosition

public void setCaretPosition(int position)
TextComponent のテキスト挿入キャレットの位置を設定します。TextComponent のテキスト挿入キャレットの位置を設定します。キャレットは変更を追跡するので、コンポーネントの基本となるテキストが変更されるとこれも移動します。ドキュメントが null の場合には何も行いません。位置は 0 とコンポーネントテキストの長さとの間でなければならず、そうでない場合は例外がスローされます。

パラメータ:
position - 位置
例外:
IllegalArgumentException - position に指定した値が 0 未満、またはコンポーネントテキストより長い場合

getCaretPosition

public int getCaretPosition()
テキストコンポーネントのテキスト挿入キャレットの位置を返します。

戻り値:
テキストコンポーネントのテキスト挿入キャレットの位置 >= 0

setText

public void setText(String t)
この TextComponent のテキストに、指定されたテキストを設定します。テキストが null または空の場合は、古いテキストを単に削除する効果があります。テキストが挿入されたときのキャレット位置は、キャレットクラスの実装によって決定されます。

このメソッドはスレッドに対して安全ですが、ほとんどの Swing メソッドは違います。詳細は、「Threads and Swing」を参照してください。 テキストはバウンドプロパティではないため、それが変更されても PropertyChangeEvent はトリガされません。テキストの変更を待機するには、DocumentListener を使用してください。

パラメータ:
t - 設定する新しいテキスト
関連項目:
getText(int, int), DefaultCaret

getText

public String getText()
この TextComponent に格納されたテキストを返します。基本となるドキュメントが null の場合は、NullPointerException を返します。 テキストはバウンドプロパティではないため、それが変更されても PropertyChangeEvent はトリガされません。テキストの変更を待機するには、DocumentListener を使用してください。

戻り値:
テキスト
例外:
NullPointerException - ドキュメントが null の場合
関連項目:
setText(java.lang.String)

getSelectedText

public String getSelectedText()
この TextComponent に格納された選択されているテキストを返します。選択領域が null であるか、ドキュメントが空の場合は、null を返します。

戻り値:
テキスト
例外:
IllegalArgumentException - 選択領域がなんらかの理由でドキュメントへの有効なマッピングを持たない場合
関連項目:
setText(java.lang.String)

isEditable

public boolean isEditable()
この TextComponent が編集可能かどうかを示す boolean 型を返します。

戻り値:
boolean 型の値
関連項目:
setEditable(boolean)

setEditable

public void setEditable(boolean b)
この TextComponent が編集可能かどうかを設定します。状態が変更されると、PropertyChange イベント (editable) が発生します。

パラメータ:
b - 設定される boolean
関連項目:
isEditable()

getSelectionStart

public int getSelectionStart()
選択したテキストの開始位置を返します。ドキュメントが空の場合は 0、選択領域がない場合はドットの値を返します。

戻り値:
開始位置 >= 0

setSelectionStart

public void setSelectionStart(int selectionStart)
選択開始を、指定された位置に設定します。新しい先頭は、現在の選択領域の末尾かその前に限定されます。

これは、このメソッドを java.awt.TextComponent で呼び出したコードに対する下位互換に役立ちます。これを実装すると、実際の選択領域が管理されている場所である Caret の実装に転送できます。

パラメータ:
selectionStart - テキストの開始位置 >= 0

getSelectionEnd

public int getSelectionEnd()
選択したテキストの末尾位置を返します。ドキュメントが空の場合は 0、選択領域がない場合はドットの値を返します。

戻り値:
末尾位置 >= 0

setSelectionEnd

public void setSelectionEnd(int selectionEnd)
選択領域の末尾を、指定された位置に設定します。新しい末尾は、現在の選択領域の先頭またはその後に限定されます。

これは、このメソッドを java.awt.TextComponent で呼び出したコードに対する下位互換に役立ちます。これを実装すると、実際の選択領域が管理されている場所である Caret の実装に転送できます。

パラメータ:
selectionEnd - テキストの末尾位置 >= 0

select

public void select(int selectionStart,
                   int selectionEnd)
指定された始点と終点の間にあるテキストを選択します。

このメソッドは選択テキストの始点と終点を設定します。始点は 0 以上でなければならないという制約が適用されます。終点は始点と同じか、それより大きい値でなければならず、またテキストコンポーネントのテキストの長さに等しいか、それより短くなければなりません。

呼び出し側が一貫性のない値または境界外の値を指定した場合、メソッドはメッセージを表示せずに、これらの制約を適用します。具体的には、始点または終点がテキストの長さを超える場合、テキストと同じ長さに設定し直します。始点がゼロより小さい場合、ゼロに設定し直します。終点が始点より小さい場合、始点に設定し直します。

この呼び出しは、下位互換のために提供されています。これは、setCaretPosition の呼び出しに回送され、それに moveCaretPostion の呼び出しが続きます。選択領域を管理するには、これらのメソッドを直接呼び出すことが望ましい方法です。

パラメータ:
selectionStart - テキストの始点
selectionEnd - テキストの終点
関連項目:
setCaretPosition(int), moveCaretPosition(int)

selectAll

public void selectAll()
TextComponent 内のすべてのテキストを選択します。null または空のドキュメントでは何も行いません。


getToolTipText

public String getToolTipText(MouseEvent event)
event のツールヒントとして使用される文字列を返します。返されるのは次のいずれかです。
  1. null 以外の値で setToolTipText が呼び出されると、その値が返される
  2. 上記 1 以外の場合は、UI 上での getToolTipText の呼び出しによる値が返される
デフォルトでは、JTextComponentToolTipManager で登録されることはありません。これは、registerComponentToolTipManager 上で呼び出されない限り、ツールヒントは TextUI から表示されないことを意味します。

オーバーライド:
クラス JComponent 内の getToolTipText
パラメータ:
event - 該当のイベント
戻り値:
event のツールヒントとして使用される文字列
関連項目:
JComponent.setToolTipText(java.lang.String), TextUI.getToolTipText(javax.swing.text.JTextComponent, java.awt.Point), ToolTipManager.registerComponent(javax.swing.JComponent)

getPreferredScrollableViewportSize

public Dimension getPreferredScrollableViewportSize()
ビューコンポーネントのビューポートの適切なサイズを返します。これを実装すると、コンポーネントの適切なサイズを返すデフォルト動作を実行できます。

定義:
インタフェース Scrollable 内の getPreferredScrollableViewportSize
戻り値:
この Scrollable をビューとして持つ JViewportpreferredSize
関連項目:
JComponent.getPreferredSize()

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle visibleRect,
                                      int orientation,
                                      int direction)
論理行または論理列を表示するコンポーネントは、orientation の値によって、新しい 1 行または 1 列を完全にエクスポーズするスクロール増分値を計算します。理論的には、コンポーネントは項目を完全にエクスポーズするために必要な距離を返すことで、部分的にエクスポーズされている行または列を処理します。

このデフォルト実装は、単純に可視領域の 10% を返します。サブクラスは、よりいっそう適正な値を提供できます。

定義:
インタフェース Scrollable 内の getScrollableUnitIncrement
パラメータ:
visibleRect - ビューポート内の可視のビュー領域
orientation - SwingConstants.VERTICAL または SwingConstants.HORIZONTAL
direction - 上または左にスクロールする場合は 0 より小さく、下または右にスクロールする場合は 0 より大きい
戻り値:
指定された方向にスクロールするための「ユニット」増分値
例外:
IllegalArgumentException - 方向が無効な場合
関連項目:
JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

public int getScrollableBlockIncrement(Rectangle visibleRect,
                                       int orientation,
                                       int direction)
論理行または論理列を表示するコンポーネントは、orientation の値によって、1 ブロック分の行または列を完全にエクスポーズするスクロール増分値を計算します。

このデフォルト実装は、単純に可視領域を返します。サブクラスは、よりいっそう適正な値を提供できます。

定義:
インタフェース Scrollable 内の getScrollableBlockIncrement
パラメータ:
visibleRect - ビューポート内の可視のビュー領域
orientation - SwingConstants.VERTICAL または SwingConstants.HORIZONTAL
direction - 上または左にスクロールする場合は 0 より小さく、下または右にスクロールする場合は 0 より大きい
戻り値:
指定された方向にスクロールするための「ブロック」増分値
例外:
IllegalArgumentException - 方向が無効な場合
関連項目:
JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()
ビューポートが、常にこの Scrollable の幅を強制的にビューポートの幅に一致させようとする場合は、true を返します。たとえば、折り返し行がビューポートの右端を越えて消えてしまうようでは不都合なので、行折り返しをサポートした通常のテキストビューはここで true を返します。上位クラスに JScrollPane を持つ Scrollable に true を返すと、水平スクロールが事実上無効になることに注意してください。

JViewport などのスクロールコンテナは、検証されるとこのメソッドを使用します。

定義:
インタフェース Scrollable 内の getScrollableTracksViewportWidth
戻り値:
ビューポートが Scrollable の幅を強制的にそれ自体に一致させる場合は true

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()
ビューポートでこの Scrollable の高さを常にビューポートの高さに合わせる場合に、true を返します。たとえば、左から右の列へテキストを表示する段組みのテキストビューの場合、このメソッドで true を返すと、垂直スクロールが事実上無効になります。

JViewport などのスクロールコンテナは、検証されるとこのメソッドを使用します。

定義:
インタフェース Scrollable 内の getScrollableTracksViewportHeight
戻り値:
ビューポートが Scrollable の高さを強制的にそれ自体に一致させる場合は true

getAccessibleContext

public AccessibleContext getAccessibleContext()
この JTextComponent に関連した AccessibleContext を取得します。テキストコンポーネントの場合、AccessibleContextAccessibleJTextComponent の形式を取ります。必要に応じて新規の AccessibleJTextComponent インスタンスが作成されます。

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス JComponent 内の getAccessibleContext
戻り値:
この JTextComponentAccessibleContext として機能する AccessibleJTextComponent

paramString

protected String paramString()
この JTextComponent の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

JFC コンポーネントの特定の新しい側面についての情報を提供するには、paramString をオーバーライドします。

オーバーライド:
クラス JComponent 内の paramString
戻り値:
この JTextComponent の文字列表現

processInputMethodEvent

protected void processInputMethodEvent(InputMethodEvent e)
クラス Component の記述:
このコンポーネントで発生するインプットメソッドイベントを、登録されているすべての InputMethodListener オブジェクトにディスパッチすることによって処理します。

このコンポーネントに対してインプットメソッドイベントが使用可能でない場合、このメソッドは呼び出されません。インプットメソッドイベントは、次のいずれかの場合に使用可能になります。

  • InputMethodListener オブジェクトが addInputMethodListener によって登録されている
  • enableEvents によってインプットメソッドイベントが使用可能になっている

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

オーバーライド:
クラス Component 内の processInputMethodEvent
パラメータ:
e - インプットメソッドイベント
関連項目:
InputMethodEvent, InputMethodListener, Component.addInputMethodListener(java.awt.event.InputMethodListener), Component.enableEvents(long)

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()
クラス Component の記述:
このコンポーネントのインプットメソッドからの要求をサポートするインプットメソッド要求ハンドラを返します。オンザスポットテキスト入力をサポートするコンポーネントは、InputMethodRequests のインスタンスを返すためにはこのメソッドをオーバーライドする必要があります。同時に、インプットメソッドイベントを処理する必要もあります。

オーバーライド:
クラス Component 内の getInputMethodRequests
戻り値:
このコンポーネントのインプットメソッド要求ハンドラ。デフォルトでは null
関連項目:
Component.addInputMethodListener(java.awt.event.InputMethodListener)

addInputMethodListener

public void addInputMethodListener(InputMethodListener l)
クラス Component の記述:
このコンポーネントからインプットメソッドイベントを受け取るために、指定されたインプットメソッドリスナーを追加します。InputMethodRequests のインスタンスを返すように getInputMethodRequests もオーバーライドする場合、コンポーネントはインプットメソッドからインプットメソッドイベントを受け取るだけです。lnull の場合、例外はスローされず、処理も実行されません。

オーバーライド:
クラス Component 内の addInputMethodListener
パラメータ:
l - インプットメソッドリスナー
関連項目:
InputMethodEvent, InputMethodListener, Component.removeInputMethodListener(java.awt.event.InputMethodListener), Component.getInputMethodListeners(), Component.getInputMethodRequests()

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。