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.AccessibleJComponent
Container.AccessibleAWTContainer
Component.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_WINDOW
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
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()
自動ドラッグ処理が有効であるかどうかを返します。
|
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, update
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, transferFocusDownCycle, validate, validateTree
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, 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, transferFocusUpCycle
public 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
- 追加されるリスナーCaretEvent
public void removeCaretListener(CaretListener listener)
listener
- 削除されるリスナーCaretEvent
public CaretListener[] getCaretListeners()
CaretListener
。キャレット・リスナーが現在登録されていない場合は、空の配列addCaretListener(javax.swing.event.CaretListener)
, removeCaretListener(javax.swing.event.CaretListener)
protected void fireCaretUpdate(CaretEvent e)
e
- イベントEventListenerList
public void setDocument(Document doc)
doc
- 表示および編集するドキュメントgetDocument()
public Document getDocument()
public void setComponentOrientation(ComponentOrientation o)
Component
LayoutManager
サブクラスおよびComponent
サブクラスはこのプロパティを使用してコンポーネントの配置方法および描画方法を決めます。
構築時には、コンポーネントの方向は、明示的に指定されていないことを示すComponentOrientation.UNKNOWN
に設定されます。UNKNOWNの方向の動作はComponentOrientation.LEFT_TO_RIGHT
と同じです。
単一コンポーネントの方向を設定する場合は、このメソッドを使用します。コンポーネント階層全体の方向を設定する場合は、applyComponentOrientation
を使用します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
setComponentOrientation
、クラス: Component
ComponentOrientation
, 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)
, TransferHandler
public boolean getDragEnabled()
dragEnabled
プロパティの値setDragEnabled(boolean)
public final void setDropMode(DropMode dropMode)
DropMode.USE_SELECTION
になっています。ただし、ユーザー経験を改善したい場合は、DropMode.INSERT
の使用をお勧めします。DropMode.INSERTでは、テキストのある位置から別の位置へのドロップとよく似た操作を実行できますが、現在選択しているテキストとキャレット位置に影響はありません。
JTextComponents
は次のドロップ・モードをサポートしています。
DropMode.USE_SELECTION
DropMode.INSERT
このコンポーネントがドロップを受け付けるTransferHandler
を持っていなければ、ドロップ・モードの効果はありません。
dropMode
- 使用するドロップ・モードIllegalArgumentException
- ドロップ・モードがサポートされていないかnull
の場合getDropMode()
, getDropLocation()
, JComponent.setTransferHandler(javax.swing.TransferHandler)
, TransferHandler
public 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)
, PlainDocument
public void write(Writer out) throws IOException
out
- 出力ストリームIOException
- 入出力エラーが発生した場合public void removeNotify()
JComponent
KeyboardAction
が削除されます。このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。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)
, DefaultCaret
public 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
、クラス: JComponent
event
- 該当のイベントevent
のツールヒントとして使用される文字列JComponent.setToolTipText(java.lang.String)
, TextUI.getToolTipText(javax.swing.text.JTextComponent, java.awt.Point)
, ToolTipManager.registerComponent(javax.swing.JComponent)
public Dimension getPreferredScrollableViewportSize()
getPreferredScrollableViewportSize
、インタフェース: Scrollable
Scrollable
をビューとして持つJViewport
のpreferredSize
JComponent.getPreferredSize()
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
このデフォルト実装は、単純に可視領域の10%を返します。サブクラスは、よりいっそう適正な値を提供できます。
getScrollableUnitIncrement
、インタフェース: Scrollable
visibleRect
- ビュー・ポート内の可視のビュー領域orientation
- SwingConstants.VERTICAL
またはSwingConstants.HORIZONTAL
direction
- 上または左にスクロールする場合は0より小さく、下または右にスクロールする場合は0より大きいIllegalArgumentException
- 方向が無効な場合JScrollBar.setUnitIncrement(int)
public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
このデフォルト実装は、単純に可視領域を返します。サブクラスは、よりいっそう適正な値を提供できます。
getScrollableBlockIncrement
、インタフェース: Scrollable
visibleRect
- ビュー・ポート内の可視のビュー領域orientation
- SwingConstants.VERTICAL
またはSwingConstants.HORIZONTAL
direction
- 上または左にスクロールする場合は0より小さく、下または右にスクロールする場合は0より大きいIllegalArgumentException
- 方向が無効な場合JScrollBar.setBlockIncrement(int)
public boolean getScrollableTracksViewportWidth()
Scrollable
の幅を強制的にビュー・ポートの幅に一致させる場合にtrueを返します。たとえば、折返し行がビュー・ポートの右端を越えて消えてしまうようでは不都合なので、行折返しをサポートした通常のテキスト・ビューはここでtrueを返します。上位クラスにJScrollPane
を持つScrollable
にtrueを返すと、水平スクロールが事実上無効になることに注意してください。
JViewport
などのスクロール・コンテナは、検証されるとこのメソッドを使用します。
getScrollableTracksViewportWidth
、インタフェース: Scrollable
Scrollable
の幅を強制的にビュー・ポートの幅に一致させる場合はtruepublic boolean getScrollableTracksViewportHeight()
Scrollable
の高さを強制的にビュー・ポートの高さと一致させる場合にtrueを返します。たとえば、左から右の列へテキストを表示する段組みのテキスト・ビューの場合、このメソッドでtrueを返すと、垂直方向のスクロールが結果的に無効になります。
JViewport
などのスクロール・コンテナは、検証されるとこのメソッドを使用します。
getScrollableTracksViewportHeight
、インタフェース: Scrollable
public boolean print() throws PrinterException
JTextComponent
を印刷する簡易印刷メソッドです。注: このメソッドは印刷が完了するまでブロックされます。
注: ヘッドレスモードでは、ダイアログは表示されません。
このメソッドは、印刷の実行時に、完全な機能を備えたprint
メソッドを呼び出します。
true
PrinterException
- 印刷システムのエラーが原因でジョブが停止した場合SecurityException
- 印刷ジョブ要求の開始がこのスレッドに許可されていない場合print(MessageFormat, MessageFormat, boolean, PrintService, PrintRequestAttributeSet, boolean)
public boolean print(MessageFormat headerFormat, MessageFormat footerFormat) throws PrinterException
JTextComponent
を印刷する簡易印刷メソッドです。注: このメソッドは印刷が完了するまでブロックされます。
注: ヘッドレスモードでは、ダイアログは表示されません。
このメソッドは、印刷の実行時に、完全な機能を備えたprint
メソッドを呼び出します。
headerFormat
- ヘッダーとして使用されるテキスト(MessageFormat
形式)。ヘッダーがない場合はnull
footerFormat
- フッターとして使用されるテキスト(MessageFormat
形式)。フッターがない場合はnull
true
PrinterException
- 印刷システムのエラーが原因でジョブが停止した場合SecurityException
- 印刷ジョブ要求の開始がこのスレッドに許可されていない場合print(MessageFormat, MessageFormat, boolean, PrintService, PrintRequestAttributeSet, boolean)
, MessageFormat
public 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
形式)。ヘッダーがない場合はnull
footerFormat
- フッターとして使用されるテキスト(MessageFormat
形式)。フッターがない場合はnull
showPrintDialog
- 印刷ダイアログを表示する場合はtrue
、そうでない場合はfalse
service
- 初期PrintService
か、デフォルトの場合はnull
attributes
- 印刷ジョブに適用されるジョブ属性。何も適用しない場合はnull
interactive
- 対話型モードで印刷するかどうかtrue
PrinterException
- 印刷システムのエラーが原因でジョブが停止した場合SecurityException
- 印刷ジョブ要求の開始がこのスレッドに許可されていない場合getPrintable(java.text.MessageFormat, java.text.MessageFormat)
, MessageFormat
, GraphicsEnvironment.isHeadless()
, FutureTask
public 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
形式)。ヘッダーがない場合はnull
footerFormat
- フッターとして使用されるテキスト(MessageFormat
形式)。フッターがない場合はnull
JTextComponent
の内容を印刷するために使用するPrintable
Printable
, PageFormat
, Document.render(java.lang.Runnable)
public AccessibleContext getAccessibleContext()
JTextComponent
に関連付けられているAccessibleContext
を取得します。テキスト・コンポーネントの場合、AccessibleContext
はAccessibleJTextComponent
の形式を取ります。必要に応じて、新しいAccessibleJTextComponent
インスタンスが作成されます。getAccessibleContext
、インタフェース: Accessible
getAccessibleContext
、クラス: Component
JTextComponent
のAccessibleContext
として機能するAccessibleJTextComponent
protected String paramString()
JTextComponent
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。
JFCコンポーネントの特定の新しい側面についての情報を提供するには、paramString
をオーバーライドします。
paramString
、クラス: JComponent
JTextComponent
の文字列表現protected void processInputMethodEvent(InputMethodEvent e)
Component
InputMethodListener
オブジェクトにディスパッチすることによって処理します。
このコンポーネントに対してインプット・メソッド・イベントが使用可能でない場合、このメソッドは呼び出されません。インプット・メソッド・イベントは、次のいずれかの場合に使用可能になります。
InputMethodListener
オブジェクトがaddInputMethodListener
によって登録されている。
enableEvents
によってインプット・メソッド・イベントが使用可能になっている。
イベント・パラメータがnull
である場合は、動作が未指定のため、例外が発生する可能性があります。
processInputMethodEvent
、クラス: Component
e
- インプット・メソッド・イベントInputMethodEvent
, InputMethodListener
, Component.addInputMethodListener(java.awt.event.InputMethodListener)
, Component.enableEvents(long)
public InputMethodRequests getInputMethodRequests()
Component
InputMethodRequests
インスタンスを返すには、このメソッドをオーバーライドする必要があります。同時に、インプット・メソッド・イベントを処理する必要もあります。getInputMethodRequests
、クラス: Component
null
Component.addInputMethodListener(java.awt.event.InputMethodListener)
public void addInputMethodListener(InputMethodListener l)
Component
InputMethodRequests
のインスタンスを返すようにgetInputMethodRequests
もオーバーライドする場合、コンポーネントはインプット・メソッドからインプット・メソッド・イベントを受け取るだけです。リスナーl
がnull
である場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
addInputMethodListener
、クラス: Component
l
- インプット・メソッド・リスナーInputMethodEvent
, InputMethodListener
, Component.removeInputMethodListener(java.awt.event.InputMethodListener)
, Component.getInputMethodListeners()
、Component.getInputMethodRequests()
protected boolean saveComposedText(int pos)
pos
- 変換テキストの位置を識別するドキュメントの位置true
、そうでない場合はfalse
restoreComposedText()
protected void restoreComposedText()
saveComposedText
によって以前保存された変換テキストを復元します。保存された変換テキストがドキュメントに挿入されます。このメソッドは、saveComposedText
がtrue
を返す場合にだけ呼び出される必要があります。saveComposedText(int)
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.