概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM 2 Platform
Standard Ed. 6
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

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 一节。

插入符更改
插入符是 swing 文本组件中的可插入对象。将插入符位置和选择的更改通知发送到已向文本组件注册的 CaretListener 接口的实现。如果尚未设置定制插入符，则该 UI 将安装默认插入符。
默认情况下，该插入符会跟踪在事件指派线程上执行的所有更改，并且如果插入发生在插入符位置或之前，或者移除发生在插入符位置之前，则相应地更新其位置。DefaultCaret 尝试使自己可见，这将导致 JScrollPane 内的文本组件发生滚动。DefaultCaret.setUpdatePolicy(int) 方法可以更改默认的插入符行为。
注：不可编辑的文本组件也有插入符，尽管可能不绘制它。

命令
文本组件提供许多可能用于操作组件的命令。这实质上是组件表示其功能的方式。这些都将根据 swing Action 接口使用 TextAction 实现来表示。文本组件支持的命令集合可以使用 getActions() 方法查找。这些操作可以绑定到由按键等触发的键事件上。

文本输入
文本组件支持灵活而且国际化的文本输入，在使用 keymap 和输入法框架的同时维护与 AWT 侦听器模型的兼容性。

Keymap 让应用程序将击键绑定到操作上。为了允许 keymap 在整个多文本组件上共享，它们可以使用扩展 TextAction 的操作。TextAction 可以确定哪个 JTextComponent 最近有或以前有过焦点，并因此成为该操作的执行者（在此情况下，发送到该操作的 ActionEvent 不包含作为其源的目标文本组件）。

input method framework 让文本组件与输入法交互，分隔预处理事件的软件组件，来让用户使用非常有限的几个键盘键输入成千上万个不同的字符。JTextComponent 是该框架的一个活动客户端，因此它可实现与输入法交互的首选用户界面。因此，有些键事件因为受输入法处理而无法到达文本组件，而有些文本输入不是作为键事件而是作为在 InputMethodEvent 内的提交文本到达文本组件的。完整的文本输入是 keyTyped 键事件中的字符和输入法事件中的提交文本的结合。

AWT 侦听器模型让应用程序将事件侦听器附加到组件，以便将事件绑定到操作。Swing 鼓励使用 keymap 替代侦听器，但要通过使用它为侦听器提供获得事件的机会来维护与侦听器的兼容性。

键盘事件和输入法事件通过以下几个阶段进行处理，每个阶段都能使用该事件：

Stage

KeyEvent

InputMethodEvent

1. 输入法 （在此处生成）
2. 焦点管理器
3. 注册的键侦听器 注册的输入法侦听器
4. 在 JTextComponent 中的输入法处理
5. 使用当前 keymap 进行 keymap 处理
6. 在 JComponent 中进行键盘处理（如加速键、组件导航等）

要维护与侦听键事件但不知道输入法事件的应用程序的兼容性，在阶段 4 中的输入法处理会提供不处理输入法事件的组件的兼容性模式。对于这些组件，可将提交文本转换为 keyTyped 键事件，并在阶段 3 开始的键事件管线中进行处理，而不是在输入法事件管线中处理。

默认情况下，组件将创建一个作为默认 keymap 由所有 JTextComponent 实例共享的 keymap（名为 DEFAULT_KEYMAP）。通常，外观实现将安装一个不同的 keymap，以便把另一个 keymap 中找不到的绑定解析为默认 keymap。该绑定最少包括：

模型/视图拆分
文本组件具有模型/视图拆分功能。文本组件会将用于表示模型、视图和控制器的对象拉在一起。文本文档模型可以由充当该模型观察者的其他视图共享（如，多个组件可以共享一个文档）。

该图表显示控制器、文档、事件和 ViewFactory 之间的交互

该模型由 Document 接口定义。此模型应提供灵活的文本存储机制，以在编辑过程中跟踪更改，并且可以扩展为更复杂的模型。该模型接口旨在捕获 SGML（用于表示多种内容的系统）提供的表达式功能。每次修改文档都会以 DocumentEvent 形式将更改的详细信息通知给所有观察者，允许视图与模型保持最新。将此事件发送给实现了 DocumentListener 接口且注册为需要正在接受观察的模型的观察者。

位置信息
提供确定视图中文本位置的功能。确定此信息有两个方法，modelToView(int) 和 viewToModel(java.awt.Point)。

撤消/恢复支持
提供对编辑历史机制的支持，以允许进行撤消/恢复操作。默认情况下文本组件本身不提供历史缓冲区，但确实提供可以与历史缓冲区一起使用的 UndoableEdit 记录以提供撤消/恢复支持。该支持由 Document 模型提供，该模型允许用户附加 UndoableEditListener 实现。

线程安全
swing 文本组件对线程安全操作提供一定程度的支持。因为文本组件的可配置性级别高，所以可以回避所提供的保护。该保护主要来自模型，因此 AbstractDocument 的文档会描述提供的假定保护。异步调用的安全方法标记为注释。

换行
有关如果处理换行的讨论，请参阅 DefaultEditorKit。

打印支持
提供了几个 print 方法进行基本文档打印。如果需要更高级的打印，请使用 getPrintable(java.text.MessageFormat, java.text.MessageFormat) 方法。

警告：此类的已序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder。

另请参见：
Document, DocumentEvent, DocumentListener, Caret, CaretEvent, CaretListener, TextUI, View, ViewFactory

嵌套类摘要
 class JTextComponent.AccessibleJTextComponent
          此类实现 JTextComponent 类的可访问性支持。
static class JTextComponent.DropLocation
          表示 JTextComponent 的放置位置 (drop location)。
static class JTextComponent.KeyBinding
          用于创建键绑定的绑定记录。
 
从类 javax.swing.JComponent 继承的嵌套类/接口
JComponent.AccessibleJComponent
 
从类 java.awt.Container 继承的嵌套类/接口
Container.AccessibleAWTContainer
 
从类 java.awt.Component 继承的嵌套类/接口
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
字段摘要
static String DEFAULT_KEYMAP
          将由所有 JTextComponent 实例共享的默认 keymap，除非这些实例已有另一个 keymap 集合。
static String FOCUS_ACCELERATOR_KEY
          焦点加速键的绑定 (bound) 属性名称。
 
从类 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)
          将一个新 keymap 添加到 keymap 层次结构。
 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()
          返回在组件上进行 DnD 操作过程中此组件在视觉上指示为放置位置的位置；如果当前没有显示任何位置，则返回 null。
 DropMode getDropMode()
          返回此组件的放置模式。
 char getFocusAccelerator()
          返回将导致接收文本组件获取焦点的加速键。
 Highlighter getHighlighter()
          获取负责进行高亮显示的对象。
 InputMethodRequests getInputMethodRequests()
          获取输入方法请求处理程序，该处理程序支持此组件输入方法发出的请求。
 Keymap getKeymap()
          获取当前在此文本组件中活动的 keymap。
static Keymap getKeymap(String nm)
          获取以前添加到文档中的已命名 keymap。
 Insets getMargin()
          返回文本组件的边框和它的文本之间的空白。
 NavigationFilter getNavigationFilter()
          返回 NavigationFilter。
 Dimension getPreferredScrollableViewportSize()
          返回视图组件视口的首选大小。
 Printable getPrintable(MessageFormat headerFormat, MessageFormat footerFormat)
          返回一个 Printable，用于打印此 JTextComponent 的内容。
 int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
          显示逻辑行或列的组件应计算滚动增量，它将根据方向的值完全公开一个行块或列块。
 boolean getScrollableTracksViewportHeight()
          如果视口总是强制此 Scrollable 的高度与视口高度匹配，则返回 true。
 boolean getScrollableTracksViewportWidth()
          如果视口总是强制此 Scrollable 的宽度与视口宽度匹配，则返回 true。
 int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
          显示逻辑行或列的组件应计算滚动增量，它将根据方向的值完全公开一个新的行或列。
 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)
           加载带有一组绑定的 keymap。
 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)
          移除以前添加到文档中的已命名 keymap。
 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)
          开启或关闭自动拖动处理。
 void setDropMode(DropMode dropMode)
          设置此组件的放置模式，为了向后兼容性，此属性的默认值为 DropMode.USE_SELECTION。
 void setEditable(boolean b)
          设置指定的 boolean 变量，以指示此 TextComponent 是否应该为可编辑的。
 void setFocusAccelerator(char aKey)
          设置将导致接收的文本组件获取焦点的加速键。
 void setHighlighter(Highlighter h)
          设置要使用的 highlighter。
 void setKeymap(Keymap map)
          设置用于将事件绑定到操作的 keymap。
 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, 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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
焦点加速键的绑定 (bound) 属性名称。

另请参见：
常量字段值

DEFAULT_KEYMAP

public static final String DEFAULT_KEYMAP
将由所有 JTextComponent 实例共享的默认 keymap，除非这些实例已有另一个 keymap 集合。

另请参见：
常量字段值
构造方法详细信息

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。设置该 UI 之后调用 invalidate。

覆盖：
类 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 所支持的命令列表，该 UI 通过编辑器本身支持的命令集进行扩充。这些命令对于绑定到事件是很有用的，例如在 keymap 中。

返回：
命令列表

setMargin

public void setMargin(Insets m)
设置组件的边框和它的文本之间的空白。文本组件的默认 Border 对象将使用此值创建适当的空白。不过，如果在文本组件上设置非默认边框，则由 Border 对象负责创建适当的空白（其他情况下实际上忽略此属性）。这会导致重绘该组件。PropertyChange 事件 ("margin") 被发送到所有侦听器。

参数：
m - 边框和文本之间的空间

getMargin

public Insets getMargin()
返回文本组件的边框和它的文本之间的空白。

返回：
空白

setNavigationFilter

public void setNavigationFilter(NavigationFilter filter)
设置 NavigationFilter。NavigationFilter 作为一种限制光标移动的方式由 DefaultCaret 和默认光标移动操作使用。

从以下版本开始：
1.4

getNavigationFilter

public NavigationFilter getNavigationFilter()
返回 NavigationFilter。NavigationFilter 作为一种限制光标移动的方式由 DefaultCaret 和默认光标移动操作使用。null 返回值意味着光标移动和选择不受限制。

返回：
NavigationFilter
从以下版本开始：
1.4

getCaret

public Caret getCaret()
获取允许在视图上进行面向文本导航的插入符。

返回：
插入符

setCaret

public void setCaret(Caret c)
设置要使用的插入符。默认情况下，这将由安装的 UI 设置。如果需要，还可以更改为定制插入符。设置插入符会导致触发一个 PropertyChange 事件 ("caret")。

参数：
c - 插入符
另请参见：
getCaret()

getHighlighter

public Highlighter getHighlighter()
获取负责进行高亮显示的对象。

返回：
highlighter

setHighlighter

public void setHighlighter(Highlighter h)
设置要使用的 highlighter。默认情况下，这将由安装的 UI 设置。如果需要，还可以更改为自定义 highlighter。可以将 highlighter 设置为 null，以禁用它。安装新 highlighter 时，将触发一个 PropertyChange 事件 ("highlighter")。

参数：
h - highlighter
另请参见：
getHighlighter()

setKeymap

public void setKeymap(Keymap map)
设置用于将事件绑定到操作的 keymap。设置为 null 可有效地禁用键盘输入。安装新 keymap 时将触发一个 PropertyChange 事件 ("keymap")。

参数：
map - keymap
另请参见：
getKeymap()

setDragEnabled

public void setDragEnabled(boolean b)
开启或关闭自动拖动处理。要启用自动拖动处理，应该将此属性设置为 true，并且组件的 TransferHandler 必须为非 null。dragEnabled 属性的默认值为 false。

遵守此属性并识别用户拖动动作的作业取决于外观实现，特别是组件的 TextUI。启用自动拖动处理时，只要用户在选择上按下鼠标按钮并将鼠标移动几个像素，多数外观（包括那些子类化 BasicLookAndFeel 的外观）就会开始拖放操作。因此将此属性设置为 true 可以对选择行为产生微妙的影响。

如果在忽略此属性的情况下使用外观，仍然可以通过在组件的 TransferHandler 上调用 exportAsDrag 开始拖放操作。

参数：
b - 是否启用自动拖动处理
抛出：
HeadlessException - 如果 b 为 true，并且 GraphicsEnvironment.isHeadless() 返回 true
从以下版本开始：
1.4
另请参见：
GraphicsEnvironment.isHeadless(), getDragEnabled(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandler

getDragEnabled

public boolean getDragEnabled()
返回是否启用自动拖动处理。

返回：
dragEnabled 属性的值
从以下版本开始：
1.4
另请参见：
setDragEnabled(boolean)

setDropMode

public final void setDropMode(DropMode dropMode)
设置此组件的放置模式，为了向后兼容性，此属性的默认值为 DropMode.USE_SELECTION。但是，为了便于用户使用，建议使用 DropMode.INSERT。它还提供类似于在文本位置之间的放置操作行为，但这样做时不影响实际文本选择和插入符位置。

JTextComponents 支持以下放置模式：

放置模式只在此组件具有接受放置的 TransferHandler 时才有意义。

参数：
dropMode - 要使用的放置模式
抛出：
IllegalArgumentException - 如果不支持该放置模式或放置模式为 null
从以下版本开始：
1.6
另请参见：
getDropMode(), getDropLocation(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandler

getDropMode

public final DropMode getDropMode()
返回此组件的放置模式。

返回：
此组件的放置模式
从以下版本开始：
1.6
另请参见：
setDropMode(javax.swing.DropMode)

getDropLocation

public final JTextComponent.DropLocation getDropLocation()
返回在组件上进行 DnD 操作过程中此组件在视觉上指示为放置位置的位置；如果当前没有显示任何位置，则返回 null。

此方法不用于从 TransferHandler 查询放置位置，因为只有在返回 TransferHandler 的 canImport 并允许显示位置后才设置放置位置。

此属性更改时，组件将触发名为 "dropLocation" 的属性更改事件。

返回：
放置位置
从以下版本开始：
1.6
另请参见：
setDropMode(javax.swing.DropMode), TransferHandler.canImport(TransferHandler.TransferSupport)

getKeymap

public Keymap getKeymap()
获取当前在此文本组件中活动的 keymap。

返回：
keymap

addKeymap

public static Keymap addKeymap(String nm,
                               Keymap parent)
将一个新 keymap 添加到 keymap 层次结构。Keymap 绑定自下向上进行解析，所以在子级中指定的属性将重写父级中指定的属性。

参数：
nm - keymap 的名称（必须为文档中命名的 keymap 集合中唯一的一个）；如果 keymap 是未命名的，则该名称可以为 null，但调用者负责管理返回的引用，因为未命名的 keymap 无法按名称获取
parent - 父级 keymap；如果未指定的绑定不需要在其他某个 keymap 中解析，则此 keymap 可以为 null
返回：
keymap

removeKeymap

public static Keymap removeKeymap(String nm)
移除以前添加到文档中的已命名 keymap。具有 null 名称的 Keymap 可以不以此方式移除。

参数：
nm - 要移除的 keymap 的名称
返回：
已移除的 keymap

getKeymap

public static Keymap getKeymap(String nm)
获取以前添加到文档中的已命名 keymap。此 keymap 不与以 null 命名的 keymap 一起使用。

参数：
nm - keymap 的名称
返回：
keymap

loadKeymap

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

加载带有一组绑定的 keymap。这可用于取得一个静态定义表，并将它们加载到某个 keymap 中。以下示例说明了将一些键绑定到与 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 - keymap
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)
用给定字符串所表示的新内容替换当前选定的内容。如果没有选择的内容，则该操作插入给定的文本。如果没有替换文本，则该操作移除当前选择的内容。

这是插入内容操作的默认实现使用的一种方法，该操作绑定了 keymap 操作。

虽然大多数 Swing 方法不是线程安全的，但此方法是线程安全的。有关更多信息，请参阅 How to Use Threads。

参数：
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
根据流进行初始化。此方法创建一个适合于组件类型的模型，并根据流初始化该�