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」を参照してください。
CaretListenerインタフェースの実装に送られます。UIは、カスタマイズしたキャレットが設定済みでないかぎりデフォルトのキャレットをインストールします。DefaultCaretは、自身を表示しようとします。このため、JScrollPane内でテキスト・コンポーネントがスクロールされることがあります。キャレットのデフォルトの動作を変更するには、DefaultCaret.setUpdatePolicy(int)メソッドを使用します。TextActionの実装を使用して、swing Actionインタフェースの形で表現されます。テキスト・コンポーネントがサポートするコマンド・セットは、getActions()メソッドで確認できます。こうしたアクションは、ボタンなどから発生するキー・イベントに割り当てられます。
Keymapで、アプリケーションを使用するとキー・ストロークをアクションにバインドできます。キーマップを複数のテキスト・コンポーネントで共有するために、TextActionを拡張するアクションを使用できます。TextActionは、どのJTextComponentがフォーカスを持っていて、アクションの対象(アクションに送られたActionEventがターゲット・テキスト・コンポーネントをソースとして含んでいない場合)であるかを判定できます。
インプット・メソッドのフレームワークで、テキスト・コンポーネントをインプット・メソッドと結び付けることができます。このインプット・メソッドは、キーのかなり少ないキーボードを使用して何千もの異なる文字をユーザーが入力できるようにするイベントを前処理する個々のソフトウェア・コンポーネントです。JTextComponentは、フレームワークのアクティブ・クライアントであるため、インプット・メソッドとやりとりするための適切なユーザー・インタフェースを実装します。結果的に、キー・イベントの中にはインプット・メソッドにより処理されるため、テキスト・コンポーネントに到達しないものがあります。また、テキスト入力の中には、キー・イベントとしてではなくInputMethodEventの中の確定テキストとして、テキスト・コンポーネントに到達するものもあります。完全なテキスト入力とは、keyTypedキー・イベントの文字と、インプット・メソッド・イベントの確定テキストとの組み合わせです。
AWTリスナー・モデルで、アプリケーションを使用してイベントをアクションにバインドするためにイベント・リスナーをコンポーネントと結び付けることができます。Swingでは、リスナーではなくキーマップを使用することを推奨していますが、イベントを消費することによりそのイベントを横取りする機会をリスナーに与えることによってリスナーとの互換性を維持しています。
キーボード・イベントとインプット・メソッド・イベントは、次の工程で処理されます。
工程 |
KeyEvent |
InputMethodEvent |
|---|---|---|
| 1. | インプット・メソッド | (ここで生成される) |
| 2. | フォーカス・マネージャ | |
| 3. | 登録済みのキー・リスナー | 登録済みのインプット・メソッド・リスナー |
| 4. | JTextComponentで処理するインプット・メソッド | |
| 5. | 現在のキーマップを使用して処理するキーマップ | |
| 6. | JComponentで処理するキーボード(アクセラレータ、コンポーネント・ナビゲーションなど) | |
キー・イベントには待機しているが、インプット・メソッド・イベントは認識しないアプリケーションとの互換性を保つため、工程4で処理するインプット・メソッドは、インプット・メソッドを処理しないコンポーネントのための互換性を提供しています。これらのコンポーネントでは、確定テキストはkeyTypedキー・イベントに変換され、インプット・メソッドのイベント・パイプラインではなく、工程3で開始されるキー・イベント・パイプラインで処理されます。
コンポーネントはデフォルトで、すべてのJTextComponentのインスタンスによってデフォルト・キーマップとして共有されるキーマップ(DEFAULT_KEYMAP)を作成します。一般的に、Look & Feelの実装は、デフォルトのキーマップに解決する別のキーマップをインストールして、デフォルトのキーマップを、別のキーマップにはないキー割当てに対応させます。次に、最小の割り当てを示します。

このモデルはDocumentインタフェースによって定義されます。これは、編集時に変更を追跡する柔軟なテキスト・ストレージ・メカニズムを提供するためのもので、より高度なモデルに拡張できます。モデル・インタフェースは、SGMLが提供する式の機能、つまり多様なコンテンツを表現するのに使うシステムを取り込むためのものです。ドキュメントに加える各修正は、ビューを最新のモデルに同期できるようにするDocumentEventという形式で変更の詳細な通知がすべてのオブザーバに送られます。このイベントは、DocumentListenerインタフェースを実装して監視中のモデルに配信対象を登録したオブザーバに送られます。
modelToView(int)とviewToModel(java.awt.Point)の2つのメソッドが用意されています。
UndoableEditレコードを提供します。そのサポートはDocumentモデルによって提供されます。このモデルにより、UndoableEditListenerの実装の追加が可能になります。
AbstractDocumentのマニュアルでは提供される保護の前提条件を説明しています。非同期で安全に呼び出せるメソッドには、コメントが付けられています。
printメソッドが用意されています。高度な印刷処理が必要な場合は、getPrintable(java.text.MessageFormat, java.text.MessageFormat)メソッドを使用します。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。1.4以降、すべてのJavaBeans(tm)用の長期間の格納サポートがjava.beansパッケージに追加されています。XMLEncoderを参照してください。
Document, DocumentEvent, DocumentListener, Caret, CaretEvent, CaretListener, TextUI, View, ViewFactory| 修飾子と型 | クラスと説明 |
|---|---|
class |
JTextComponent.AccessibleJTextComponent
このクラスは
JTextComponentクラスのアクセシビリティ・サポートを実装しています。 |
static class |
JTextComponent.DropLocation
JTextComponentのドロップ位置を表します。 |
static class |
JTextComponent.KeyBinding
キー・バインド作成用のレコードを割り当てます。
|
JComponent.AccessibleJComponentContainer.AccessibleAWTContainerComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy| 修飾子と型 | フィールドと説明 |
|---|---|
static String |
DEFAULT_KEYMAP
異なるキーマップ・セットを持っていないかぎり、全
JTextComponentインスタンスで共有されるデフォルトのキーマップです。 |
static String |
FOCUS_ACCELERATOR_KEY
フォーカス・アクセラレータのバウンド・プロパティ名です。
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWaccessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, 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()
自動ドラッグ処理が有効であるかどうかを返します。
|
JTextComponent.DropLocation |
getDropLocation()
このコンポーネントがコンポーネントのドラッグ&ドロップ時にドロップ位置として視覚的に示す位置を返します。現在位置が表示されていない場合は
nullを返します。 |
DropMode |
getDropMode()
このコンポーネントのドロップ・モードを返します。
|
char |
getFocusAccelerator()
受信側テキスト・コンポーネントにフォーカスを取得させるキー・アクセラレータを返します。
|
Highlighter |
getHighlighter()
ハイライトをつけるのに使用されるオブジェクトを取り出します。
|
InputMethodRequests |
getInputMethodRequests()
このコンポーネントのインプット・メソッドからの要求をサポートするインプット・メソッド要求ハンドラを取得します。
|
Keymap |
getKeymap()
このテキスト・コンポーネントで現在アクティブなキーマップを取り出します。
|
static Keymap |
getKeymap(String nm)
それまでにドキュメントに追加されていた名前付きキーマップを取り出します。
|
Insets |
getMargin()
テキスト・コンポーネントの境界とそのテキストの間のマージンを返します。
|
NavigationFilter |
getNavigationFilter()
NavigationFilterを返します。 |
Dimension |
getPreferredScrollableViewportSize()
ビュー・コンポーネントのビュー・ポートの適切なサイズを返します。
|
Printable |
getPrintable(MessageFormat headerFormat, MessageFormat footerFormat)
この
JTextComponentの内容を印刷するために使用するPrintableを返します。 |
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()
システム・クリップボードのコンテンツを関連するテキスト・モデルに転送します。
|
boolean |
print()
印刷ダイアログを表示し、対話型モードで、ヘッダー・テキストまたはフッター・テキストを指定しないでこの
JTextComponentを印刷する簡易印刷メソッドです。 |
boolean |
print(MessageFormat headerFormat, MessageFormat footerFormat)
印刷ダイアログを表示し、対話型モードで、ヘッダー・テキストおよびフッター・テキストを指定してこの
JTextComponentを印刷する簡易印刷メソッドです。 |
boolean |
print(MessageFormat headerFormat, MessageFormat footerFormat, boolean showPrintDialog, PrintService service, PrintRequestAttributeSet attributes, boolean interactive)
この
JTextComponentの内容を印刷します。 |
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)
現在選択されているコンテンツを、渡された文字列が示す新しいコンテンツで置き換えます。
|
protected void |
restoreComposedText()
saveComposedTextによって以前保存された変換テキストを復元します。 |
protected boolean |
saveComposedText(int pos)
指定された位置の周りの変換テキストを保存します。
|
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)
自動ドラッグ処理をオンまたはオフにします。
|
void |
setDropMode(DropMode dropMode)
このコンポーネントのドロップ・モードを設定します。
|
void |
setEditable(boolean b)
この
TextComponentが編集可能かどうかを示す指定されたbooleanを設定します。 |
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)
モデルのコンテンツを、指定されたストリームに格納します。
|
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, 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, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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, updateadd, 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, transferFocusDownCycle, validate, validateTreeaction, 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, 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, transferFocusBackward, transferFocusUpCyclepublic static final String FOCUS_ACCELERATOR_KEY
public JTextComponent()
JTextComponentを作成します。キャレット・イベントのリスナーが確立され、プラグイン可能なUIがインストールされます。コンポーネントは編集可能とマークされます。配置はテキストのビュー・サブシステムによって管理されるので、レイアウト・マネージャは使用されません。ドキュメント・モデルはnullに設定されます。public TextUI getUI()
public void setUI(TextUI ui)
ui - ファクトリpublic void updateUI()
getUIClassID()です。UIのタイプはTextUIです。invalidateは、UIの設定後に呼び出されます。public void addCaretListener(CaretListener listener)
listener - 追加されるリスナーCaretEventpublic void removeCaretListener(CaretListener listener)
listener - 削除されるリスナーCaretEventpublic CaretListener[] getCaretListeners()
CaretListener。キャレット・リスナーが現在登録されていない場合は、空の配列addCaretListener(javax.swing.event.CaretListener), removeCaretListener(javax.swing.event.CaretListener)protected void fireCaretUpdate(CaretEvent e)
e - イベントEventListenerListpublic void setDocument(Document doc)
doc - 表示および編集するドキュメントgetDocument()public Document getDocument()
public void setComponentOrientation(ComponentOrientation o)
ComponentLayoutManagerサブクラスおよびComponentサブクラスはこのプロパティを使用してコンポーネントの配置方法および描画方法を決めます。
構築時には、コンポーネントの方向は、明示的に指定されていないことを示すComponentOrientation.UNKNOWNに設定されます。UNKNOWNの方向の動作はComponentOrientation.LEFT_TO_RIGHTと同じです。
単一コンポーネントの方向を設定する場合は、このメソッドを使用します。コンポーネント階層全体の方向を設定する場合は、applyComponentOrientationを使用します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
setComponentOrientation 、クラス: ComponentComponentOrientation, Component.invalidate()public Action[] getActions()
public void setMargin(Insets m)
Borderオブジェクトは、この値を使って適切なマージンを作成します。ただし、デフォルト以外の境界が設定されている場合は、Borderオブジェクトが適切なマージン空白を作成します(それ以外の場合、このプロパティは事実上無視される)。このため、コンポーネントの再描画が行われます。PropertyChangeイベント(margin)はすべてのリスナーに送られます。m - ボーダーとテキストの間のマージンpublic Insets getMargin()
public void setNavigationFilter(NavigationFilter filter)
NavigationFilterを設定します。NavigationFilterはDefaultCaretと、カーソルの移動を限定するデフォルトのカーソル移動アクションで使用されます。public NavigationFilter getNavigationFilter()
NavigationFilterを返します。NavigationFilterはDefaultCaretと、カーソルの移動を限定するデフォルトのカーソル移動アクションで使用されます。戻り値のnullはカーソルの移動と選択が制限されないことを表します。public Caret getCaret()
public void setCaret(Caret c)
c - キャレットgetCaret()public Highlighter getHighlighter()
public void setHighlighter(Highlighter h)
nullに設定します。新しいハイライタがインストールされると、PropertyChangeイベント(highlighter)が発生します。h - ハイライタgetHighlighter()public void setKeymap(Keymap map)
nullに設定すると、キーボード入力が事実上無効になります。新しいキーマップをインストールすると、PropertyChangeイベント(keymap)が発生します。map - キーマップgetKeymap()public void setDragEnabled(boolean b)
trueに設定し、コンポーネントのTransferHandlerの値をnon-nullにしてください。dragEnabledプロパティのデフォルト値はfalseです。
このプロパティを受け入れ、ユーザーのドラッグ・ジェスチャを認識する処理は、Look & Feel実装(特にコンポーネントのTextUI)によって行われます。自動ドラッグ処理が有効である場合、ほとんどのLook & Feel (BasicLookAndFeelのサブクラスのLook & Feelを含む)は、ユーザーが選択項目の上でマウス・ボタンを押し、マウスを数ピクセル移動すると、ドラッグ&ドロップ操作を開始します。したがって、このプロパティをtrueに設定すると、選択の動作に微妙に影響する場合があります。
このプロパティを無視するようなLook & Feelを使用している場合も、コンポーネントのTransferHandler上でexportAsDragを呼び出すことにより、ドラッグ&ドロップ操作を開始できます。
b - 自動ドラッグ処理を有効にするかどうかHeadlessException - bがtrueで、GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless(), getDragEnabled(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandlerpublic boolean getDragEnabled()
dragEnabledプロパティの値setDragEnabled(boolean)public final void setDropMode(DropMode dropMode)
DropMode.USE_SELECTIONになっています。ただし、ユーザー経験を改善したい場合は、DropMode.INSERTの使用をお勧めします。DropMode.INSERTでは、テキストのある位置から別の位置へのドロップとよく似た操作を実行できますが、現在選択しているテキストとキャレット位置に影響はありません。
JTextComponentsは次のドロップ・モードをサポートしています。
DropMode.USE_SELECTIONDropMode.INSERT
このコンポーネントがドロップを受け付けるTransferHandlerを持っていなければ、ドロップ・モードの効果はありません。
dropMode - 使用するドロップ・モードIllegalArgumentException - ドロップ・モードがサポートされていないかnullの場合getDropMode(), getDropLocation(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandlerpublic final DropMode getDropMode()
setDropMode(javax.swing.DropMode)public final JTextComponent.DropLocation getDropLocation()
nullを返します。
このメソッドは、TransferHandlerからドロップ位置を照会する手段にはなりません。ドロップ位置は、TransferHandlerのcanImportが返され、ドロップ位置を表示する準備ができてから設定されるためです。
このプロパティが変更されると、コンポーネントにより、プロパティ変更イベントdropLocationがトリガーされます。
setDropMode(javax.swing.DropMode), TransferHandler.canImport(TransferHandler.TransferSupport)public Keymap getKeymap()
public static Keymap addKeymap(String nm, Keymap parent)
nm - キーマップの名前。ドキュメント内の名前付きキーマップのコレクションの中で一意である必要がある。キーマップに名前を指定しない場合、名前はnullでもかまわない。ただし、名前なしのキーマップは名前を指定して取得することができないので、返された参照の管理は呼出し側で行うparent - 親キーマップ。未指定の割り当てをほかの特定のキーマップで解釈処理する必要がない場合は、nullを設定できるpublic static Keymap removeKeymap(String nm)
nullであるキーマップは、この方法では削除できません。nm - 削除するキーマップの名前public static Keymap getKeymap(String nm)
nullであるキーマップは扱いません。nm - キーマップの名前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 - アクションのセットpublic Color getCaretColor()
public void setCaretColor(Color c)
nullに設定すると、効果的にデフォルトの色を復元します。色を設定すると、PropertyChangeイベント(caretColor)が発生します。c - 色getCaretColor()public Color getSelectionColor()
public void setSelectionColor(Color c)
nullを設定することは、Color.whiteを設定することと同じです。色を設定すると、PropertyChangeイベント(selectionColor)が発生します。c - 色getSelectionColor()public Color getSelectedTextColor()
public void setSelectedTextColor(Color c)
nullを設定することは、Color.blackと同じです。色を設定すると、PropertyChangeイベント(selectedTextColor)が発生します。c - 色getSelectedTextColor()public Color getDisabledTextColor()
public void setDisabledTextColor(Color c)
c - 色getDisabledTextColor()public void replaceSelection(String content)
このメソッドは、キーマップ・アクションに割り当てられるコンテンツを挿入するアクションのデフォルト実装によって使用されます。
content - 選択範囲を置き換えるコンテンツpublic String getText(int offs, int len) throws BadLocationException
offs - オフセット≥ 0len - 長さ≥ 0BadLocationException - オフセットまたは長さが無効な場合public Rectangle modelToView(int pos) throws BadLocationException
pos - 位置≥ 0BadLocationException - 指定された位置が、関連するドキュメント内の有効な位置を示さない場合TextUI.modelToView(javax.swing.text.JTextComponent, int)public int viewToModel(Point pt)
pt - 変換対象のビューの座標系での位置TextUI.viewToModel(javax.swing.text.JTextComponent, java.awt.Point)public void cut()
nullの場合には何も行いません。public void copy()
nullの場合には何も行いません。public void paste()
public void moveCaretPosition(int pos)
setCaretPositionが前回呼び出されたときに定義されたマークは残しておきます。このメソッドは、選択領域を形成します。ドキュメントがnullの場合には何も行いません。位置は0とコンポーネント・テキストの長さとの間でなければならず、そうでない場合は例外がスローされます。pos - 位置IllegalArgumentException - positionに指定した値が0未満、またはコンポーネント・テキストより長い場合setCaretPosition(int)public void setFocusAccelerator(char aKey)
aKey - 鍵getFocusAccelerator()public char getFocusAccelerator()
public void read(Reader in, Object desc) throws IOException
in - 読込み元のストリームdesc - ストリームを記述するオブジェクト。String、File、URLなど。ある種のドキュメント(たとえばHTML)は、この情報を利用できる場合がある。null以外の場合、ドキュメントのプロパティとして追加されるIOException - 初期化に使用されるストリームによってスローされるEditorKit.createDefaultDocument(), setDocument(javax.swing.text.Document), PlainDocumentpublic void write(Writer out) throws IOException
out - 出力ストリームIOException - 入出力エラーが発生した場合public void removeNotify()
JComponentKeyboardActionが削除されます。このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。public void setCaretPosition(int position)
TextComponentのテキスト挿入キャレットの位置を設定します。キャレットは変更を追跡するので、コンポーネントのベースとなるテキストが変更されるとこれも移動することに注意してください。ドキュメントがnullの場合には何も行いません。位置は0とコンポーネント・テキストの長さとの間でなければならず、そうでない場合は例外がスローされます。position - 位置IllegalArgumentException - positionに指定した値が0未満、またはコンポーネント・テキストより長い場合public int getCaretPosition()
public void setText(String t)
TextComponentのテキストに、指定されたテキストを設定します。テキストがnullまたは空の場合は、古いテキストを単に削除する効果があります。テキストが挿入されたときに結果として得られるキャレット位置は、キャレット・クラスの実装によって決定されます。
テキストはバウンド・プロパティではないため、それが変更されてもPropertyChangeEvent はトリガーされません。テキストの変更を待機するには、DocumentListenerを使用してください。
t - 設定する新しいテキストgetText(int, int), DefaultCaretpublic String getText()
TextComponentに格納されたテキストを返します。ベースとなるドキュメントがnullの場合は、NullPointerExceptionを返します。テキストはバウンド・プロパティではないため、それが変更されてもPropertyChangeEvent はトリガーされません。テキストの変更を待機するには、DocumentListenerを使用してください。NullPointerException - ドキュメントがnullの場合setText(java.lang.String)public String getSelectedText()
TextComponentに格納された選択されているテキストを返します。選択領域がnullであるか、ドキュメントが空の場合は、nullを返します。IllegalArgumentException - 選択領域が何らかの理由でドキュメントへの有効なマッピングを持たない場合setText(java.lang.String)public boolean isEditable()
TextComponentが編集可能かどうかを示すbooleanを返します。setEditable(boolean)public void setEditable(boolean b)
TextComponentが編集可能かどうかを示す指定されたbooleanを設定します。状態が変更されると、PropertyChangeイベント(editable)が発生します。b - 設定されるbooleanisEditable()public int getSelectionStart()
public void setSelectionStart(int selectionStart)
これは、このメソッドをjava.awt.TextComponentで呼び出したコードに対する下位互換に役立ちます。これを実装すると、実際の選択領域が管理されている場所であるCaretの実装に転送できます。
selectionStart - テキストの開始位置≥ 0public int getSelectionEnd()
public void setSelectionEnd(int selectionEnd)
これは、このメソッドをjava.awt.TextComponentで呼び出したコードに対する下位互換に役立ちます。これを実装すると、実際の選択領域が管理されている場所であるCaretの実装に転送できます。
selectionEnd - テキストの末尾位置≥ 0public void select(int selectionStart,
int selectionEnd)
このメソッドは選択テキストの始点と終点を設定します。始点は0以上でなければならないという制約が適用されます。終点は始点と同じか、それより大きい値でなければならず、またテキスト・コンポーネントのテキストの長さに等しいか、それより短くなければいけません。
呼出し側が一貫性のない値または境界外の値を指定した場合、メソッドはメッセージを表示せずに、これらの制約を適用します。具体的には、始点または終点がテキストの長さを超える場合、テキストと同じ長さに設定し直します。始点がゼロより小さい場合、ゼロに設定し直します。終点が始点より小さい場合、始点に設定し直します。
この呼出しは、下位互換のために提供されています。これは、setCaretPositionの呼出しに回送され、それにmoveCaretPositionの呼出しが続きます。選択領域を管理する望ましい方法は、これらのメソッドを直接呼び出すことです。
selectionStart - テキストの始点selectionEnd - テキストの終点setCaretPosition(int), moveCaretPosition(int)public void selectAll()
TextComponent内のすべてのテキストを選択します。nullまたは空のドキュメントでは何も行いません。public String getToolTipText(MouseEvent event)
eventのツールヒントとして使用される文字列を返します。返されるのは次のいずれかです。
null以外の値でsetToolTipTextが呼び出されると、その値が返される。そうでない場合は
getToolTipTextの呼出しによる値が返される。
JTextComponentがToolTipManagerで登録されることはありません。これは、registerComponentがToolTipManager上で呼び出されないかぎり、ツールヒントはTextUIから表示されないことを意味します。getToolTipText 、クラス: JComponentevent - 該当のイベントeventのツールヒントとして使用される文字列JComponent.setToolTipText(java.lang.String), TextUI.getToolTipText(javax.swing.text.JTextComponent, java.awt.Point), ToolTipManager.registerComponent(javax.swing.JComponent)public Dimension getPreferredScrollableViewportSize()
getPreferredScrollableViewportSize 、インタフェース: ScrollableScrollableをビューとして持つJViewportのpreferredSizeJComponent.getPreferredSize()public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
このデフォルト実装は、単純に可視領域の10%を返します。サブクラスは、よりいっそう適正な値を提供できます。
getScrollableUnitIncrement 、インタフェース: ScrollablevisibleRect - ビュー・ポート内の可視のビュー領域orientation - SwingConstants.VERTICALまたはSwingConstants.HORIZONTALdirection - 上または左にスクロールする場合は0より小さく、下または右にスクロールする場合は0より大きいIllegalArgumentException - 方向が無効な場合JScrollBar.setUnitIncrement(int)public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
このデフォルト実装は、単純に可視領域を返します。サブクラスは、よりいっそう適正な値を提供できます。
getScrollableBlockIncrement 、インタフェース: ScrollablevisibleRect - ビュー・ポート内の可視のビュー領域orientation - SwingConstants.VERTICALまたはSwingConstants.HORIZONTALdirection - 上または左にスクロールする場合は0より小さく、下または右にスクロールする場合は0より大きいIllegalArgumentException - 方向が無効な場合JScrollBar.setBlockIncrement(int)public boolean getScrollableTracksViewportWidth()
Scrollableの幅を強制的にビュー・ポートの幅に一致させる場合にtrueを返します。たとえば、折返し行がビュー・ポートの右端を越えて消えてしまうようでは不都合なので、行折返しをサポートした通常のテキスト・ビューはここでtrueを返します。上位クラスにJScrollPaneを持つScrollableにtrueを返すと、水平スクロールが事実上無効になることに注意してください。
JViewportなどのスクロール・コンテナは、検証されるとこのメソッドを使用します。
getScrollableTracksViewportWidth 、インタフェース: ScrollableScrollableの幅を強制的にビュー・ポートの幅に一致させる場合はtruepublic boolean getScrollableTracksViewportHeight()
Scrollableの高さを強制的にビュー・ポートの高さと一致させる場合にtrueを返します。たとえば、左から右の列へテキストを表示する段組みのテキスト・ビューの場合、このメソッドでtrueを返すと、垂直方向のスクロールが結果的に無効になります。
JViewportなどのスクロール・コンテナは、検証されるとこのメソッドを使用します。
getScrollableTracksViewportHeight 、インタフェース: Scrollablepublic boolean print()
throws PrinterException
JTextComponentを印刷する簡易印刷メソッドです。注: このメソッドは印刷が完了するまでブロックされます。
注: ヘッドレスモードでは、ダイアログは表示されません。
このメソッドは、印刷の実行時に、完全な機能を備えたprintメソッドを呼び出します。
truePrinterException - 印刷システムのエラーが原因でジョブが停止した場合SecurityException - 印刷ジョブ要求の開始がこのスレッドに許可されていない場合print(MessageFormat, MessageFormat, boolean, PrintService, PrintRequestAttributeSet, boolean)public boolean print(MessageFormat headerFormat, MessageFormat footerFormat) throws PrinterException
JTextComponentを印刷する簡易印刷メソッドです。注: このメソッドは印刷が完了するまでブロックされます。
注: ヘッドレスモードでは、ダイアログは表示されません。
このメソッドは、印刷の実行時に、完全な機能を備えたprintメソッドを呼び出します。
headerFormat - ヘッダーとして使用されるテキスト(MessageFormat形式)。ヘッダーがない場合はnullfooterFormat - フッターとして使用されるテキスト(MessageFormat形式)。フッターがない場合はnulltruePrinterException - 印刷システムのエラーが原因でジョブが停止した場合SecurityException - 印刷ジョブ要求の開始がこのスレッドに許可されていない場合print(MessageFormat, MessageFormat, boolean, PrintService, PrintRequestAttributeSet, boolean), MessageFormatpublic boolean print(MessageFormat headerFormat, MessageFormat footerFormat, boolean showPrintDialog, PrintService service, PrintRequestAttributeSet attributes, boolean interactive) throws PrinterException
JTextComponentの内容を印刷します。注: このメソッドは印刷が完了するまでブロックされます。
MessageFormat引数を指定すると、ページのヘッダー・テキストとフッター・テキストを出力に追加できます。印刷コードは、それらの形式からStringsを要求して、書式付き文字列に含まれる単一の項目(現在のページ番号を表すInteger)を提供します。
showPrintDialog booleanパラメータを使用すると、印刷ダイアログがユーザーに表示されるかどうかを指定できます。ダイアログが表示されると、ユーザーはそれを使用して印刷属性を変更したり、印刷を取り消したりすることができます。
serviceでは、印刷ダイアログの初期値PrintServiceや、ダイアログが表示されないときに印刷するPrintServiceを指定できます。
attributesは、印刷ダイアログの初期値を指定したり、ダイアログが表示されないときに必要な属性を提供するために使用できます。attributesを使って、ジョブの印刷方法(両面または片面)を制御できます。
interactive booleanパラメータでは、印刷を対話型モードで行うかどうかを指定できます。trueの場合は、印刷中に中止オプションの付いた進捗ダイアログが表示されます。このダイアログは、イベント・ディスパッチ・スレッド上でprintを行う場合はモーダル、それ以外の場合は非モーダルです。警告: イベント・ディスパッチ・スレッド上で、interactive falseを指定してこのメソッドを呼び出すと、印刷が完了するまで、再ペイントを含むすべてのイベントの処理が中断されます。表示できるGUIのないアプリケーションから印刷するときにのみfalseを指定することをお勧めします。
注: ヘッドレス・モードでは、showPrintDialogパラメータとinteractiveパラメータが無視されるため、ダイアログは表示されません。
このメソッドを使用すると、印刷中にdocumentが変更される心配がありません。視覚的に指定するには、印刷中にsetEnabled(false)を設定します。
このメソッドは、getPrintable(java.text.MessageFormat, java.text.MessageFormat)を使ってドキュメントの内容をレンダリングします。
このメソッドはスレッド・セーフですが、ほとんどのSwingメソッドは違います。詳細は、「Swingの同時実行性」を参照してください。
使用例。次のコードの抜粋は、クロス・プラットフォーム型の印刷ダイアログを表示し、対話型モードでJTextComponentを印刷します(ただしユーザーが印刷ダイアログを取り消した場合を除く)。
textComponent.print(new MessageFormat("My text component header"),
new MessageFormat("Footer. Page - {0}"), true, null, null, true);
イベント・ディスパッチ・スレッド以外でこのコードを実行すると、バックグラウンドで印刷が行われます。バックグラウンド印刷では、次のパターンが使用されることがあります。
FutureTask<Boolean> future =
new FutureTask<Boolean>(
new Callable<Boolean>() {
public Boolean call() {
return textComponent.print(.....);
}
});
executor.execute(future);
headerFormat - ヘッダーとして使用されるテキスト(MessageFormat形式)。ヘッダーがない場合はnullfooterFormat - フッターとして使用されるテキスト(MessageFormat形式)。フッターがない場合はnullshowPrintDialog - 印刷ダイアログを表示する場合はtrue、そうでない場合はfalseservice - 初期PrintServiceか、デフォルトの場合はnullattributes - 印刷ジョブに適用されるジョブ属性。何も適用しない場合はnullinteractive - 対話型モードで印刷するかどうかtruePrinterException - 印刷システムのエラーが原因でジョブが停止した場合SecurityException - 印刷ジョブ要求の開始がこのスレッドに許可されていない場合getPrintable(java.text.MessageFormat, java.text.MessageFormat), MessageFormat, GraphicsEnvironment.isHeadless(), FutureTaskpublic Printable getPrintable(MessageFormat headerFormat, MessageFormat footerFormat)
JTextComponentの内容を印刷するために使用するPrintableを返します。返されるPrintableは、用紙のサイズに合わせて、画面に表示したとおりにドキュメントを印刷します。複雑なレポートやドキュメントを作成する場合は、返されるPrintableを別のPrintableにラップすることもできます。
返されるPrintableは、このJTextComponentとdocumentを共有します。開発者が責任を持って、このPrintableの使用中にdocumentが変更されないようにします。印刷中にdocumentが変更されると、印刷動作は保証されません。
MessageFormat引数を指定すると、ページのヘッダー・テキストとフッター・テキストを出力に追加できます。印刷コードは、それらの形式からStringsを要求して、書式付き文字列に含まれる単一の項目(現在のページ番号を表すInteger)を提供します。
印刷時に返されるPrintableは、ページ・サイズに合わせてドキュメントの内容の書式設定を行います。行折返しを適切に行うためには、全ページのimageable widthを同じにする必要があります。PageFormat.getImageableWidth()を参照してください。
このメソッドはスレッド・セーフですが、ほとんどのSwingメソッドは違います。詳細は、Swingの同時実行性を参照してください。
返されるPrintableは、どのスレッド上でも印刷できます。
この実装の返されるPrintableは、どのスレッド上で使用されているかに関係なく、イベント・ディスパッチ・スレッド上のすべてのペイントを実行します。
headerFormat - ヘッダーとして使用されるテキスト(MessageFormat形式)。ヘッダーがない場合はnullfooterFormat - フッターとして使用されるテキスト(MessageFormat形式)。フッターがない場合はnullJTextComponentの内容を印刷するために使用するPrintablePrintable, PageFormat, Document.render(java.lang.Runnable)public AccessibleContext getAccessibleContext()
JTextComponentに関連付けられているAccessibleContextを取得します。テキスト・コンポーネントの場合、AccessibleContextはAccessibleJTextComponentの形式を取ります。必要に応じて、新しいAccessibleJTextComponentインスタンスが作成されます。getAccessibleContext 、インタフェース: AccessiblegetAccessibleContext、クラス: ComponentJTextComponentのAccessibleContextとして機能するAccessibleJTextComponentprotected String paramString()
JTextComponentの文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、nullにはなりません。
JFCコンポーネントの特定の新しい側面についての情報を提供するには、paramStringをオーバーライドします。
paramString 、クラス: JComponentJTextComponentの文字列表現protected void processInputMethodEvent(InputMethodEvent e)
ComponentInputMethodListenerオブジェクトにディスパッチすることによって処理します。
このコンポーネントに対してインプット・メソッド・イベントが使用可能でない場合、このメソッドは呼び出されません。インプット・メソッド・イベントは、次のいずれかの場合に使用可能になります。
InputMethodListenerオブジェクトがaddInputMethodListenerによって登録されている。
enableEventsによってインプット・メソッド・イベントが使用可能になっている。
イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。
processInputMethodEvent 、クラス: Componente - インプット・メソッド・イベントInputMethodEvent, InputMethodListener, Component.addInputMethodListener(java.awt.event.InputMethodListener), Component.enableEvents(long)public InputMethodRequests getInputMethodRequests()
ComponentInputMethodRequestsインスタンスを返すには、このメソッドをオーバーライドする必要があります。同時に、インプット・メソッド・イベントを処理する必要もあります。getInputMethodRequests 、クラス: ComponentnullComponent.addInputMethodListener(java.awt.event.InputMethodListener)public void addInputMethodListener(InputMethodListener l)
ComponentInputMethodRequestsのインスタンスを返すようにgetInputMethodRequestsもオーバーライドする場合、コンポーネントはインプット・メソッドからインプット・メソッド・イベントを受け取るだけです。リスナーlがnullである場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
addInputMethodListener 、クラス: Componentl - インプット・メソッド・リスナーInputMethodEvent, InputMethodListener, Component.removeInputMethodListener(java.awt.event.InputMethodListener), Component.getInputMethodListeners()、Component.getInputMethodRequests()protected boolean saveComposedText(int pos)
pos - 変換テキストの位置を識別するドキュメントの位置true、そうでない場合はfalserestoreComposedText()protected void restoreComposedText()
saveComposedTextによって以前保存された変換テキストを復元します。保存された変換テキストがドキュメントに挿入されます。このメソッドは、saveComposedTextがtrueを返す場合にだけ呼び出される必要があります。saveComposedText(int) バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.