JTextComponent (Java Platform SE 8 )

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.text.JTextComponent

All Implemented Interfaces:: ImageObserver， MenuContainer， Serializable， Accessible， Scrollable

已知直接子类：: JEditorPane， JTextArea， JTextField

public abstract class JTextComponent
extends JComponent
implements Scrollable, Accessible

JTextComponent是Swing文本组件的基类。它试图兼容 java.awt.TextComponent类，它能合理地这样做。还提供了额外的灵活性，其他服务（超出可插拔的UI和豆支持）。你可以找到关于如何使用功能 General Rules for Using Text Components提供这类，java教程中的一部分。

卡雷特的变化

插入符号是摆在文本组件可插拔的对象。变化的插入位置和选择的通知发送到的 CaretListener接口已在文本组件注册的实现。UI将会安装一个默认符号除非定制符号已定。默认情况下，插入跟踪所有文件的变化对事件调度线程和更新它的位置，因此如果插入发生之前或在插入位置或删除发生在插入位置进行
。 DefaultCaret试图使自己可见可能导致在 JScrollPane文本组件滚动。默认的符号行为可以由 DefaultCaret.setUpdatePolicy(int)方法改变。
注：不可编辑的文本成分也有符号虽然可能不是画。

命令

文本组件提供了一个可以用来操作组件的命令。这本质上是组件表示它的能力的方式。这些都是在摆动 Action接口来表示，用 TextAction实施。通过文本组件支持的命令集，可以发现与 getActions()方法。这些动作可以绑定到键事件，从按钮发射等。

文本输入

文本组件支持灵活和国际化的文字输入，使用键盘和输入法框架，同时保持与AWT监听器模型相容性。

一个Keymap让应用程序绑定按键动作。为了让键盘能够跨越多个文本组件共享的，他们可以使用的行动，延长TextAction。TextAction可以确定哪个JTextComponent最近已经或有集中的，因此是行动的主体（在该情况下，ActionEvent送到行动不包含目标文本组件作为其来源）。

input method framework让文本组件的输入方法相互配合，独立的软件组件预处理事件让用户输入用键盘用更少的按键数千个不同的字。JTextComponent框架的一个活跃的客户，从而实现用户界面的首选输入方法的相互作用。因此，一些关键的事件不因为他们是由一个输入方法处理达到文本组件，和一些文本输入到文本组件作为致力于文本内的InputMethodEvent而不是作为一个重要的事件。完整的文本输入是keyTyped关键事件的特征相结合，致力于文本输入法事件。

AWT监听器模型允许应用程序添加事件监听器组件以绑定事件的行动。摆动鼓励使用键盘而不是听众，而是保持兼容的听众给听众一个机会通过消耗偷窃事件。

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

Stage	KeyEvent	InputMethodEvent
1.	input methods	(generated here)
2.	focus manager
3.	registered key listeners	registered input method listeners
4.		input method handling in JTextComponent
5.	keymap handling using the current keymap
6.	keyboard handling in JComponent (e.g. accelerators, component navigation, etc.)

为了保持与侦听密钥事件的应用程序的兼容性，但不知道输入方法事件，在阶段4中的输入法处理提供了不处理输入法事件的组件的兼容性模式。这些组件，致力于文本转换为keytyped关键事件和关键事件的处理管道从3阶段而不是在输入法事件的管道。

默认组件将创建一个映射（命名为default_keymap）作为默认键盘映射的所有jtextcomponent实例共享。一个典型的外观和感觉的实施将安装一个不同的键盘布局，解决在不同的键盘布局没有发现那些绑定的默认键盘映射。最小绑定包括：

插入内容到编辑器中的打印键。
用退格键和Del键删除内容。
插入运动前后

模型/视图分割

文本组件有一个模型视图分割。一个文本组件将用来表示模型、视图和控制器的对象拉到一起。文本文档模型可以共享的其他视图，作为模型的观察员（例如，一个文档可以由多个组件共享）。

Diagram showing interaction between Controller, Document, events, and ViewFactory

该模型是由Document接口定义。这是为了提供一个灵活的文本存储机制，跟踪在编辑过程中的变化，并可以扩展到更复杂的模型。模型的接口是为了捕捉了SGML的表达能力，用来表达各种各样的内容体系。每一个修改的文件导致细节的改变通知被送往一个DocumentEvent允许视图保持最新与模型的形式所有的观察者。这一事件被发送到已实施DocumentListener接口与模型观察注册兴趣的观察员。

位置信息

确定在视图中的文本的位置的能力。有两种方法，确定该信息 modelToView(int)和 viewToModel(java.awt.Point)。

撤消/重做支持

提供了一个编辑历史机制的支持，以允许撤消/重做操作。文本组件本身不提供默认的历史缓冲区，但不提供 UndoableEdit记录，可结合使用历史缓存提供的撤消/重做支持。支持的文档模型，它允许一个高度undoableeditlistener实现。

线程安全

摆动文本组件为线程安全操作提供了一些支持。由于该文本组件配置水平高，有可能规避提供的保护。保护主要来自于模型，所以 AbstractDocument文档描述的假设提供的保障。异步调用异步的方法都标有注释。

换行符

对于如何处理一个换行符的讨论，看 DefaultEditorKit。

打印支持

提供基本的文档打印几 print方法。如果需要更先进的印刷方法，使用 getPrintable(java.text.MessageFormat, java.text.MessageFormat)。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4，为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。

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

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`class`	`JTextComponent.AccessibleJTextComponent` 这个类实现了对 `JTextComponent`类可访问性支持。
`static class`	`JTextComponent.DropLocation` 代表 `JTextComponent`s放置位置。
`static class`	`JTextComponent.KeyBinding` 创建密钥绑定的绑定记录。

Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`DEFAULT_KEYMAP` 默认键盘映射，将所有 `JTextComponent`实例共享除非他们有一个不同的键设置。
`static String`	`FOCUS_ACCELERATOR_KEY` 聚焦加速器的绑定属性名称。

Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法
Constructor and Description
`JTextComponent()` 创建一个新的 `JTextComponent`。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`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()` 获取与此相关的 `AccessibleContext` `JTextComponent`。
`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()` 取你所该文本组件目前活跃。
`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`可编辑或不。
`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`编辑指定的布尔值。
`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)` 将该模型的内容存储到给定的流中。

Methods inherited from class 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, 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

Methods inherited from class 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, transferFocusDownCycle, validate, validateTree

Methods inherited from class 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, 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

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - FOCUS_ACCELERATOR_KEY
```
public static final String FOCUS_ACCELERATOR_KEY
```
    聚焦加速器的绑定属性名称。
    
    另请参见：
    
    Constant Field Values
  - DEFAULT_KEYMAP
```
public static final String DEFAULT_KEYMAP
```
    默认键盘映射，将所有 JTextComponent实例共享除非他们有一个不同的键设置。
    
    另请参见：
    
    Constant Field Values
- Constructor Detail
  - JTextComponent
```
public JTextComponent()
```
    创建一个新的 JTextComponent。对于插入事件的监听器的建立，和可插拔的UI安装。组件被标记为可编辑。没有使用布局管理器，因为布局是由文本的视图子系统管理的。文档模型设置为 null。
- 方法详细信息
  - getUI
```
public TextUI getUI()
```
    取此文本编辑器的用户界面厂。
    
    结果
    
    本厂
  - setUI
```
public void setUI(TextUI ui)
```
    设置此文本为导向的编辑器的用户界面工厂。
    
    参数
    
    ui -工厂
  - updateUI
```
public void updateUI()
```
    重新加载插件UI。主要用于获取新的界面 getUIClassID()。用户界面的类型 TextUI。 invalidate后设置UI叫。
    
    重写：
    
    updateUI 方法重写，继承类 JComponent
    
    另请参见：
    
    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()
```
    返回所有插入听众本文组件注册一个数组。
    
    结果
    
    所有这些组件的 CaretListeners或空数组如果没有符号的听众正在注册
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    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事件（“文档”）传播到每一位听众。
    
    参数
    
    doc -文档显示/编辑
    
    另请参见：
    
    getDocument()
  - getDocument
```
public Document getDocument()
```
    与编辑相关的模型。这主要是为用户界面获得的最小的状态所需的是一个文本编辑器。子类将返回一种通常是扩展文档的模型的实际类型。
    
    结果
    
    模型
  - setComponentOrientation
```
public void setComponentOrientation(ComponentOrientation o)
```
    从阶级复制的描述： Component
    
    设置用于在该组件中订购元素或文本的语言敏感的方向。语言的敏感 LayoutManager和 Component子类将使用此属性确定如何布置和绘制组件。
    在施工的时候，一个组件的方向设置为ComponentOrientation.UNKNOWN，表明它还没有被明确的指定。未知的方向表现为ComponentOrientation.LEFT_TO_RIGHT相同。
    
    要设置单个组件的方向，使用此方法。将整个组件的层次定位，使用applyComponentOrientation。
    
    这种方法改变布局的相关信息，因此，无效的组件层次结构。
    
    重写：
    
    setComponentOrientation 方法重写，继承类 Component
    
    另请参见：
    
    ComponentOrientation， Component.invalidate()
  - getActions
```
public Action[] getActions()
```
    获取编辑命令列表。这是由插入的命令的集合所支持的命令列表，即编辑器本身所支持的命令集的集合。这些都是有用的结合事件，如在一个键映射。
    
    结果
    
    命令列表
  - setMargin
```
public void setMargin(Insets m)
```
    在文本组件的边框和它的文本之间设置边缘空间。文本组件的默认 Border对象将使用此值来适当的利润创造。然而，如果一个非默认的边界上设置的文本组件，它是 Border对象的责任创造适当的利润空间（其他属性可以有效地被忽略）。这导致一个重绘的成分。一个propertychange事件（“保证金”）发送给所有的听众。
    
    参数
    
    m的边框和文字之间的空间
  - getMargin
```
public Insets getMargin()
```
    返回文本组件之间的边界和它的文本之间的界限。
    
    结果
    
    保证金
  - setNavigationFilter
```
public void setNavigationFilter(NavigationFilter filter)
```
    集 NavigationFilter。 NavigationFilter由 DefaultCaret和默认的光标移动的行为作为一种限制光标的移动应用。
    
    从以下版本开始：
    
    一点四
  - getNavigationFilter
```
public NavigationFilter getNavigationFilter()
```
    返回 NavigationFilter。 NavigationFilter由 DefaultCaret和默认的光标移动的行为作为一种限制光标的移动应用。一个空的返回值意味着光标的移动和选择不应该受到限制。
    
    结果
    
    的navigationfilter
    
    从以下版本开始：
    
    一点四
  - getCaret
```
public Caret getCaret()
```
    获取符号允许在视图的文本导航。
    
    结果
    
    插入符号
  - setCaret
```
public void setCaret(Caret c)
```
    设置要使用的符号。默认情况下，将设置由安装的用户界面。这可以改变一个自定义符号如果需要。在propertychange事件设置插入的结果（“插入”）被解雇。
    
    参数
    
    c -插入
    
    另请参见：
    
    getCaret()
  - getHighlighter
```
public Highlighter getHighlighter()
```
    负责制定重点对象获取。
    
    结果
    
    亮点
  - setHighlighter
```
public void setHighlighter(Highlighter h)
```
    设置要使用的荧光笔。默认情况下，将设置由安装的用户界面。这可以改变一个自定义高亮如果需要。亮点可以设置 null禁用它。一个propertychange事件（“笔”）是一个新安装时激发的荧光笔。
    
    参数
    
    h -亮点
    
    另请参见：
    
    getHighlighter()
  - setKeymap
```
public void setKeymap(Keymap map)
```
    设置用于绑定事件行为的映射。设置 null禁用键盘输入。一个propertychange事件（“映射”）是一种新的键盘布局安装时触发。
    
    参数
    
    map -键映射
    
    另请参见：
    
    getKeymap()
  - setDragEnabled
```
public void setDragEnabled(boolean b)
```
    打开或关闭自动拖动处理。为了使自动拖动处理，此属性应设置为 true，和组件的 TransferHandler需要 non-null。的 dragEnabled属性的默认值是 false
    履行这一性质的工作，并识别用户拖动手势，在外观和感觉的实现，和特别是，组件的TextUI。当启用自动拖动处理，大多数的外观和感觉（包括那些类BasicLookAndFeel）开始拖放操作时，用户按下鼠标按钮，然后移动鼠标选择几个像素。将此属性设置为true因此可以有选择的行为有潜移默化的影响。
    
    如果一个外观和感觉的应用，忽略了这个属性，你可以开始拖动，通过对组件的调用操作TransferHandler exportAsDrag滴。
    。
    
    参数
    
    b -是否启用自动拖动处理
    
    异常
    
    HeadlessException -如果 b是 true和 GraphicsEnvironment.isHeadless()返回 true
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()， getDragEnabled()， JComponent.setTransferHandler(javax.swing.TransferHandler)， TransferHandler
  - getDragEnabled
```
public boolean getDragEnabled()
```
    返回是否启用自动拖动处理。
    
    结果
    
    该 dragEnabled属性的值
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    setDragEnabled(boolean)
  - setDropMode
```
public final void setDropMode(DropMode dropMode)
```
    设置此组件的下拉模式。为了向后兼容，此属性的默认值是 DropMode.USE_SELECTION。使用 DropMode.INSERT推荐，然而，对于改善用户体验。它提供了把文本之间的位置类似的行为，但不影响实际的文本选择和插入符号的位置。
    JTextComponents支持以下降模式：
    - DropMode.USE_SELECTION
    - DropMode.INSERT
    如果该组件有一个TransferHandler接受滴滴模式才是有意义的。
    参数
    
    dropMode -下降模式的使用
    
    异常
    
    IllegalArgumentException -如果滴模式不被支持或 null
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    getDropMode()， getDropLocation()， JComponent.setTransferHandler(javax.swing.TransferHandler)， TransferHandler
  - getDropMode
```
public final DropMode getDropMode()
```
    返回此组件的下拉模式。
    
    结果
    
    此组件的下拉模式
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    setDropMode(javax.swing.DropMode)
  - getDropLocation
```
public final JTextComponent.DropLocation getDropLocation()
```
    返回的位置，这个组件应该在视觉上显示为下降位置DND操作期间在组件，或 null如果没有定位是目前被证明。
    这种方法并不意味着查询从一个TransferHandler放置位置，如放置位置设置后，TransferHandler的canImport回来了，已经允许将只显示位置。
    
    这个属性变化时，一个名为“droplocation”是由组件发射属性更改事件。
    
    结果
    
    放置位置
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    setDropMode(javax.swing.DropMode)， TransferHandler.canImport(TransferHandler.TransferSupport)
  - getKeymap
```
public Keymap getKeymap()
```
    取你所该文本组件目前活跃。
    
    结果
    
    你所
  - addKeymap
```
public static Keymap addKeymap(String nm,
                               Keymap parent)
```
    添加到映射层次新的键盘布局。键绑定解决自下而上的这么一个孩子在一个指定的属性将覆盖在家长指定的属性。
    
    参数
    
    nm -键映射的名称（必须在文件命名的键盘在集合中是唯一的）；名称可以 null如果键是匿名的，但对方负责管理引用一位不愿透露姓名的你所不能取的名字返回
    
    parent -父键映射；这可能是 null如果未指定绑定不需要在其他一些你所解决的
    
    结果
    
    你所
  - removeKeymap
```
public static Keymap removeKeymap(String nm)
```
    删除命名映射之前添加到文档。与 null名称快捷键也不能这样删除。
    
    参数
    
    nm -键映射的名称删除
    
    结果
    
    你所被删除
  - getKeymap
```
public static Keymap getKeymap(String nm)
```
    获取一个名叫keymap先前添加到文档。这不 null-named键盘工作。
    
    参数
    
    nm -键映射的名称
    
    结果
    
    你所
  - loadKeymap
```
public static void loadKeymap(Keymap map,
                              JTextComponent.KeyBinding[] bindings,
                              Action[] actions)
```
    加载一大堆绑定键映射。这可以用来定义一个静态表和负载到一些键映射。下面举例说明结合一些钥匙例切、复制、粘贴的行为与jtextcomponent相关。一个代码片段来完成这可能看起来如下：
```
   static final JTextComponent.KeyBinding[] defaultBindings = {
     new JTextComponent.KeyBinding(
       KeyStroke.getKeyStroke(KeyEvent.VK_C, InputEvent.CTRL_MASK),
       DefaultEditorKit.copyAction),
     new JTextComponent.KeyBinding(
       KeyStroke.getKeyStroke(KeyEvent.VK_V, InputEvent.CTRL_MASK),
       DefaultEditorKit.pasteAction),
     new JTextComponent.KeyBinding(
       KeyStroke.getKeyStroke(KeyEvent.VK_X, InputEvent.CTRL_MASK),
       DefaultEditorKit.cutAction),
   };

   JTextComponent c = new JTextPane();
   Keymap k = c.getKeymap();
   JTextComponent.loadKeymap(k, defaultBindings, c.getActions());

 
```
    绑定和行为的集合可能是空的但必须是非 null。
    参数
    
    map -键映射
    
    bindings -绑定
    
    actions -动作集
  - getCaretColor
```
public Color getCaretColor()
```
    获取用于渲染插入当前的颜色。
    
    结果
    
    颜色
  - setCaretColor
```
public void setCaretColor(Color c)
```
    设置用于插入当前的颜色渲染。设置 null有效恢复默认的颜色。在propertychange事件设置颜色的结果（“caretcolor”）被解雇。
    
    参数
    
    c -颜色
    
    另请参见：
    
    getCaretColor()
  - getSelectionColor
```
public Color getSelectionColor()
```
    获取用于渲染选择当前颜色。
    
    结果
    
    颜色
  - setSelectionColor
```
public void setSelectionColor(Color c)
```
    设置用于呈现选择的当前颜色。设置颜色 null是设置 Color.white相同。在propertychange事件设置颜色的结果（“selectioncolor”）。
    
    参数
    
    c -颜色
    
    另请参见：
    
    getSelectionColor()
  - getSelectedTextColor
```
public Color getSelectedTextColor()
```
    获取用于使选定的文本的颜色。
    
    结果
    
    颜色
  - setSelectedTextColor
```
public void setSelectedTextColor(Color c)
```
    设置用于呈现所选文本的当前颜色。设置颜色 null是 Color.black相同。在propertychange事件设置颜色的结果（“selectedtextcolor”）被解雇。
    
    参数
    
    c -颜色
    
    另请参见：
    
    getSelectedTextColor()
  - getDisabledTextColor
```
public Color getDisabledTextColor()
```
    获取用于渲染禁用的文本的颜色。
    
    结果
    
    颜色
  - setDisabledTextColor
```
public void setDisabledTextColor(Color c)
```
    设置用于呈现禁用文本的当前颜色。设置颜色propertychange触发了一个事件（“disabledtextcolor”）。
    
    参数
    
    c -颜色
    
    另请参见：
    
    getDisabledTextColor()
  - replaceSelection
```
public void replaceSelection(String content)
```
    将当前选定的内容替换为由给定的字符串表示的新内容。如果没有选择，这相当于给定文本的插入。如果没有替换文本，这相当于当前选择的删除。
    这是方法，是行为的默认实现用于将内容绑定到键的行为。
    
    参数
    
    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值小于零或大于组件的文本长度
    
    另请参见：
    
    setCaretPosition(int)
  - setFocusAccelerator
```
public void setFocusAccelerator(char aKey)
```
    设置键加速器，将导致接收文本组件获得焦点。加速器将是特定于平台的修改器键的键组合，以及给定的字符（转换为大写）。例如，ALT键作为Windows上的改性剂和Ctrl + Alt组合使用Mac。默认情况下，没有聚焦加速器键。以往任何加速器设置将被取代。一个“0”键设置将被注册，并有关闭焦点加速器的效果。当新的密钥集，一propertychange事件（focus_accelerator_key）将被解雇。
    
    参数
    
    aKey的关键
    
    另请参见：
    
    getFocusAccelerator()
  - getFocusAccelerator
```
public char getFocusAccelerator()
```
    返回将导致接收文本组件获得焦点的键加速器。如果没有集中加速器，返回“0”。
    
    结果
    
    的关键
  - read
```
public void read(Reader in,
                 Object desc)
          throws IOException
```
    初始化从流。这创建了一个合适的组件模型和初始化模型从流。默认情况下，将加载该模型为纯文本。以前的内容的模型被丢弃。
    
    参数
    
    in流--读
    
    desc物体描述流；这可能是一个字符串，文件、URL等各种文档（如HTML为例）可以利用这种信息；如果非 null，它作为文档的属性
    
    异常
    
    IOException -由流被用来初始化抛出
    
    另请参见：
    
    EditorKit.createDefaultDocument()， setDocument(javax.swing.text.Document)， PlainDocument
  - write
```
public void write(Writer out)
           throws IOException
```
    将该模型的内容存储到给定的流中。默认情况下，这将存储模型为纯文本。
    
    参数
    
    out -输出流
    
    异常
    
    IOException -任何I/O错误
  - removeNotify
```
public void removeNotify()
```
    从阶级复制的描述： JComponent
    
    通知这个组件，它不再有父组件。调用此方法时，任何 KeyboardActions设置在链父组件被移除。这种方法被内部调用的工具包，不应该直接调用程序。
    
    重写：
    
    removeNotify 方法重写，继承类 JComponent
    
    另请参见：
    
    JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)
  - setCaretPosition
```
public void setCaretPosition(int position)
```
    为 TextComponent设置文本插入符号的位置。注意插入轨道的变化，所以这可能如果组件的潜在改变移动文本。如果该文件是 null，不。该位置必须介于0和组件的文本的长度之间，否则将引发异常。
    
    参数
    
    position -位置
    
    异常
    
    IllegalArgumentException如果提供 position值小于零或大于组件的文本长度
  - getCaretPosition
```
public int getCaretPosition()
```
    返回文本组件的文本插入符号的位置。
    
    结果
    
    的文本组件≥0文本插入符号的位置
  - setText
```
public void setText(String t)
```
    设置指定的文本，这 TextComponent文本。如果文本是 null或空的，有效果的简单的删除旧的文本。当文本被插入，插入的位置产生的符号类的实现决定。
    请注意，文本不是一个绑定属性，所以没有PropertyChangeEvent 开火时的变化。听课文的变化，使用DocumentListener。
    
    参数
    
    t要设置新的文本
    
    另请参见：
    
    getText(int, int)， DefaultCaret
  - getText
```
public String getText()
```
    返回包含在这 TextComponent文本。如果底层文件 null，将 NullPointerException。请注意，文本不是一个绑定属性，所以没有 PropertyChangeEvent 开火时的变化。听课文的变化，使用 DocumentListener。
    
    结果
    
    文本
    
    异常
    
    如果该文件是 null NullPointerException
    
    另请参见：
    
    setText(java.lang.String)
  - getSelectedText
```
public String getSelectedText()
```
    返回选定的文本包含在本 TextComponent。如果选择的是 null或文件是空的，返回 null。
    
    结果
    
    文本
    
    异常
    
    IllegalArgumentException如果选择没有有效的映射到一些原因的文件
    
    另请参见：
    
    setText(java.lang.String)
  - isEditable
```
public boolean isEditable()
```
    返回布尔值指示此 TextComponent可编辑或不。
    
    结果
    
    布尔值
    
    另请参见：
    
    setEditable(boolean)
  - setEditable
```
public void setEditable(boolean b)
```
    设置指示是否应该 TextComponent编辑指定的布尔值。一个propertychange事件（“编辑”）发射时的状态变化。
    
    参数
    
    b -布尔定
    
    另请参见：
    
    isEditable()
  - getSelectionStart
```
public int getSelectionStart()
```
    返回选定文本的起始位置。返回0的一个空的文档，或点的值，如果没有选择。
    
    结果
    
    开始的位置≥0
  - setSelectionStart
```
public void setSelectionStart(int selectionStart)
```
    设置选择开始到指定的位置。新的出发点被限制为之前或在当前选择结束。
    这是可用的代码调用此方法java.awt.TextComponent向后兼容性。这是实现了Caret实现这是现实的选择是保持。
    
    参数
    
    selectionStart -文本≥0开始的位置
  - getSelectionEnd
```
public int getSelectionEnd()
```
    返回选定的文本的结束位置。返回0，如果文档是空的，或点的值，如果没有选择。
    
    结果
    
    结束位置≥0
  - setSelectionEnd
```
public void setSelectionEnd(int selectionEnd)
```
    将选择端设置为指定位置。新的结束点被限制在当前选择开始或之后。
    这是可用的代码调用此方法java.awt.TextComponent向后兼容性。这是实现了Caret实现这是现实的选择是保持。
    
    参数
    
    selectionEnd -文本≥0的结束位置
  - select
```
public void select(int selectionStart,
                   int selectionEnd)
```
    选择指定的开始和结束位置之间的文本。
    该方法设置选定文本的起始和结束位置，执行起始位置必须大于或等于零的限制。结束位置必须大于或等于起始位置，且小于或等于文本组件文本的长度。
    
    如果调用方提供不一致或不一致的值，则该方法在无故障的条件下进行强制执行这些约束，并无需。具体地说，如果起始位置或结束位置大于文本的长度，则将它重置为等于文本长度。如果起始位置小于零，则复位为零，如果结束位置小于起始位置，则复位到起始位置。
    
    此调用为向后兼容性提供了。这是到一个叫setCaretPosition接着一个电话moveCaretPosition。管理选择的首选方法是直接调用这些方法。
    
    参数
    
    selectionStart -文本的起始位置
    
    selectionEnd -文本的结束位置
    
    另请参见：
    
    setCaretPosition(int)， moveCaretPosition(int)
  - selectAll
```
public void selectAll()
```
    选择在 TextComponent所有文本。没有一个 null或空文档。
  - getToolTipText
```
public String getToolTipText(MouseEvent event)
```
    返回作为 event工具提示字符串。这将返回一个：默认情况下 JTextComponent
    1. 如果setToolTipText已与non-null值调用时，它将返回，否则
    2. 通过getToolTipText在UI的值将返回。
    不与 ToolTipManager登记本身。这意味着提示将不会显示从 TextUI除非 registerComponent一直在 ToolTipManager调用。
    重写：
    
    getToolTipText 方法重写，继承类 JComponent
    
    参数
    
    event -事件的问题
    
    结果
    
    作为 event工具提示字符串
    
    另请参见：
    
    JComponent.setToolTipText(java.lang.String)， TextUI.getToolTipText(javax.swing.text.JTextComponent, java.awt.Point)， ToolTipManager.registerComponent(javax.swing.JComponent)
  - getPreferredScrollableViewportSize
```
public Dimension getPreferredScrollableViewportSize()
```
    返回一个视图的视图组件的首选大小。这是实现的，做返回组件的首选大小的默认行为。
    
    Specified by:
    
    getPreferredScrollableViewportSize 接口 Scrollable
    
    结果
    
    一个 JViewport的观点是这 Scrollable的 preferredSize
    
    另请参见：
    
    JComponent.getPreferredSize()
  - getScrollableUnitIncrement
```
public int getScrollableUnitIncrement(Rectangle visibleRect,
                                      int orientation,
                                      int direction)
```
    显示逻辑行或列的组件应该计算将完全暴露一个新的行或列的滚动增量，这取决于方向的值。理想情况下，组件应该通过返回完全暴露项目所需的距离来处理部分暴露的行或列。
    默认实现这一个是简单返回10%的可见光区域。子类很可能能够提供一个更合理的价值。
    
    Specified by:
    
    getScrollableUnitIncrement 接口 Scrollable
    
    参数
    
    visibleRect -视图的视口内的可见区域
    
    orientation - SwingConstants.VERTICAL或 SwingConstants.HORIZONTAL
    
    direction -小于零的滚动/左，大于零的下/右
    
    结果
    
    用于在指定方向上滚动的“单位”增量
    
    异常
    
    IllegalArgumentException -无效的取向
    
    另请参见：
    
    JScrollBar.setUnitIncrement(int)
  - getScrollableBlockIncrement
```
public int getScrollableBlockIncrement(Rectangle visibleRect,
                                       int orientation,
                                       int direction)
```
    显示逻辑行或列的组件应该计算将完全暴露一个行或列的一个块的滚动增量，这取决于方向的值。
    这是简单地返回可见区域的默认实现。子类可能会提供一个更合理的价值。
    
    Specified by:
    
    getScrollableBlockIncrement 接口 Scrollable
    
    参数
    
    visibleRect -视图的视口内的可见区域
    
    orientation - SwingConstants.VERTICAL或 SwingConstants.HORIZONTAL
    
    direction -小于零的滚动/左，大于零的下/右
    
    结果
    
    用于在指定方向上滚动的“块”增量
    
    异常
    
    IllegalArgumentException -无效的取向
    
    另请参见：
    
    JScrollBar.setBlockIncrement(int)
  - getScrollableTracksViewportWidth
```
public boolean getScrollableTracksViewportWidth()
```
    如果一个视图中应力这 Scrollable宽度到视口的宽度匹配，返回true。例如，一个正常的文本视图支持换行将返回这里，因为这将是不受欢迎的包线消失在视窗的右边缘。注意，返回TRUE一 Scrollable祖先一 JScrollPane有效地禁止水平滚动。
    滚动的容器，如JViewport，会用这种方法每次都被验证。
    
    Specified by:
    
    getScrollableTracksViewportWidth 接口 Scrollable
    
    结果
    
    如果视应力 Scrollables宽度匹配自己的
  - getScrollableTracksViewportHeight
```
public boolean getScrollableTracksViewportHeight()
```
    如果一个视图中应力这 Scrollable高度匹配视口高度返回true。例如，在左至右列的一个柱状文本视图可以有效地禁用垂直滚动，在这里返回真实的。
    滚动的容器，如JViewport，会用这种方法每次都被验证。
    
    Specified by:
    
    getScrollableTracksViewportHeight 接口 Scrollable
    
    结果
    
    如果视应力scrollables高度匹配自己的
  - print
```
public boolean print()
              throws PrinterException
```
    一个方便的打印方法，显示打印对话框，然后打印这 JTextComponent互动模式中没有页眉或页脚文本。注：此方法块，直到打印完成。
    注：在无头模式，没有对话框将显示。
    
    这种方法称为全功能的print法进行印刷。
    
    结果
    
    true，除非打印用户取消了
    
    异常
    
    PrinterException -如果在打印系统错误导致工作被中止
    
    SecurityException -如果该线程是不允许启动打印作业的要求
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    print(MessageFormat, MessageFormat, boolean, PrintService, PrintRequestAttributeSet, boolean)
  - print
```
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
  - print
```
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块全部的事件的事件调度线程包括重画，直到完成从印刷加工。只有在没有可见的图形用户界面的应用程序中打印时，它才被推荐使用。
    
    注：在无头模式，showPrintDialog和interactive参数被忽略，没有对话框显示。
    
    该方法保证了document不是突变在印刷。表明它在视觉上，setEnabled(false)设置打印时间。
    
    该方法采用getPrintable(java.text.MessageFormat, java.text.MessageFormat)渲染文档内容。
    
    这种方法是线程安全的，虽然大多数摇摆方法不是。更多信息请见 Concurrency in Swing。
    
    示例用法。这个代码片段显示了一个跨平台的打印对话框，然后打印JTextComponent在互动模式，除非用户取消对话框：
```
textcomponent。打印（新MessageFormat（“我的文本组件标题”），新的格式（“页脚。页- { 0 }“），真的，空，空，真的；
```
    执行此代码的事件调度线程执行对背景印刷。以下模式可用于背景印刷：
```
futuretask 
 
            
            
            
          
            
          <布尔>
           
             
           
             
             
             
  未来=新的futuretask布尔>（
  
             
             
             
           
             
           <新的赎回<布尔>
             （）{公共布尔call() {返回textcomponent打印（.....）；}}）；执行（未来）； 
           
 
            
            
            
          
            
          
```
    参数
    
    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
  - getPrintable
```
public Printable getPrintable(MessageFormat headerFormat,
                              MessageFormat footerFormat)
```
    返回一个 Printable印刷使用的这 JTextComponent内容。返回的 Printable打印文档看起来屏幕上除了重组以适应纸张。返回的 Printable可以包裹在一个 Printable为了创建复杂的报告和文件。
    返回的Printable股这JTextComponent的document。这是开发商的责任，确保document不突变，而这Printable使用。打印行为是未定义的document突变在印刷时。
    
    页眉和页脚文本可以提供MessageFormat参数添加到输出。打印代码的要求Strings从格式，提供一个单一的项目可能包括在格式化字符串：表示当前页码Integer。
    
    返回的Printable当打印格式的页面大小的文件内容。正确换行所有网页的imageable width必须相同。看到PageFormat.getImageableWidth()。
    
    这种方法是线程安全的，虽然大多数摇摆方法不是。更多信息请见 Concurrency in Swing。
    
    返回的Printable可以打印在任何线程。
    
    此实现返回Printable执行所有的画在事件调度线程，不管用什么线。
    
    参数
    
    headerFormat -文本，在 MessageFormat，作为标题，或 null没有头
    
    footerFormat -文本，在 MessageFormat，作为页脚，或 null没有页脚
    
    结果
    
    用在这 JTextComponent印刷内容 Printable
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Printable， PageFormat， Document.render(java.lang.Runnable)
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与此相关的 AccessibleContext JTextComponent。文本组件，该 AccessibleContext以一个 AccessibleJTextComponent形式。一个新的 AccessibleJTextComponent实例被创建时。
    
    Specified by:
    
    getAccessibleContext 接口 Accessible
    
    重写：
    
    getAccessibleContext 方法重写，继承类 Component
    
    结果
    
    一个 AccessibleJTextComponent作为本 JTextComponent的 AccessibleContext
  - paramString
```
protected String paramString()
```
    返回该 JTextComponent字符串表示形式。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。
    最重要的paramString提供关于JFC组件的特定的新方面的信息。
    
    重写：
    
    paramString 方法重写，继承类 JComponent
    
    结果
    
    这 JTextComponent字符串表示形式
  - processInputMethodEvent
```
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)
  - getInputMethodRequests
```
public InputMethodRequests getInputMethodRequests()
```
    从阶级复制的描述： Component
    
    获取支持此组件的输入方法的输入法请求处理程序。一个支持现场文本输入组件必须重写此方法以返回一个 InputMethodRequests实例。在同一时间，它也有处理输入法事件。
    
    重写：
    
    getInputMethodRequests 方法重写，继承类 Component
    
    结果
    
    输入法的请求处理程序这一部分， null默认
    
    另请参见：
    
    Component.addInputMethodListener(java.awt.event.InputMethodListener)
  - addInputMethodListener
```
public void addInputMethodListener(InputMethodListener l)
```
    从阶级复制的描述： Component
    
    添加指定的输入法侦听器从该组件接收输入法事件。一个组件将只接收输入法输入方法的事件是否也覆盖 getInputMethodRequests返回一个 InputMethodRequests实例。如果听众 l是 null，不引发异常，则不执行行动。
    参考AWT Threading Issues对AWT的线程模型的细节。
    
    重写：
    
    addInputMethodListener 方法重写，继承类 Component
    
    参数
    
    l -输入监听方法
    
    另请参见：
    
    InputMethodEvent， InputMethodListener， Component.removeInputMethodListener(java.awt.event.InputMethodListener)， Component.getInputMethodListeners()， Component.getInputMethodRequests()
  - saveComposedText
```
protected boolean saveComposedText(int pos)
```
    在指定位置保存组合文本。在指定位置的组合文本（如果有的话）保存在备份存储中，并从文档中删除。
    
    参数
    
    pos文件位置的确定由文本定位
    
    结果
    
    true如果由文本存在和保存， false否则
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    restoreComposedText()
  - restoreComposedText
```
protected void restoreComposedText()
```
    恢复以前保存的 saveComposedText正文。保存的组合文本插入到文档中。这种方法应该只被调用如果 saveComposedText返回 true。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    saveComposedText(int)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class JTextComponent

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Field Detail

FOCUS_ACCELERATOR_KEY

DEFAULT_KEYMAP

Constructor Detail

JTextComponent

方法详细信息

getUI

setUI

updateUI

addCaretListener

removeCaretListener

getCaretListeners

fireCaretUpdate

setDocument

getDocument

setComponentOrientation

getActions

setMargin

getMargin

setNavigationFilter

getNavigationFilter

getCaret

setCaret

getHighlighter

setHighlighter

setKeymap

setDragEnabled

getDragEnabled

setDropMode

getDropMode

getDropLocation

getKeymap

addKeymap

removeKeymap

getKeymap

loadKeymap

getCaretColor

setCaretColor

getSelectionColor

setSelectionColor

getSelectedTextColor

setSelectedTextColor

getDisabledTextColor

setDisabledTextColor

replaceSelection

getText

modelToView

viewToModel

cut

copy

paste

moveCaretPosition

setFocusAccelerator

getFocusAccelerator

read

write

removeNotify

setCaretPosition

getCaretPosition

setText

getText

getSelectedText

isEditable

setEditable

getSelectionStart