javax.swing

Class JTextPane

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.text.JTextComponent

javax.swing.JEditorPane

javax.swing.JTextPane

All Implemented Interfaces:

ImageObserver， MenuContainer， Serializable， Accessible， Scrollable

public class JTextPane
extends JEditorPane

一个可以标记的文本组件，可以用图形表示的属性标记。你可以找到在 Using Text Components使用文本窗格的how-to信息和例子，java教程中的一部分。

此组件模型的段落是由字符级属性的运行组成的。每一段可以有一个合乎逻辑的方式连接到它包含默认属性使用属性如果不被设置在段落或字符运行。组件和图像可以嵌入在文本流中。

换行符

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

警告： Swing是线程不安全的。更多信息见Swing's Threading Policy。

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

另请参见：

StyledEditorKit

Nested Class Summary

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

JEditorPane.AccessibleJEditorPane, JEditorPane.AccessibleJEditorPaneHTML, JEditorPane.JEditorPaneAccessibleHypertextSupport

Nested classes/interfaces inherited from class javax.swing.text.JTextComponent

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, 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 inherited from class javax.swing.JEditorPane

HONOR_DISPLAY_PROPERTIES, W3C_LENGTH_UNITS

Fields inherited from class javax.swing.text.JTextComponent

DEFAULT_KEYMAP, 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
JTextPane() 创建一个新的 JTextPane。
JTextPane(StyledDocument doc) 创建一个新的 JTextPane，用指定的文档模型。

方法摘要

Modifier and Type	Method and Description
Style	addStyle(String nm, Style parent) 在逻辑样式层次结构中添加一个新样式。
protected EditorKit	createDefaultEditorKit() 创建 EditorKit默认使用的。
AttributeSet	getCharacterAttributes() 引进效果的人物属性在插入当前位置，或 null。
MutableAttributeSet	getInputAttributes() 获取窗格的输入属性。
Style	getLogicalStyle() 获取指定的插入当前位置为代表的段落的逻辑风格，或 null。
AttributeSet	getParagraphAttributes() 获取当前影响段落属性在插入符号的位置，或 null如果没有。
Style	getStyle(String nm) 获取一个名叫非 null风格以前添加的。
StyledDocument	getStyledDocument() 与编辑相关的模型。
protected StyledEditorKit	getStyledEditorKit() 获取编辑器工具包。
String	getUIClassID() 返回用户界面的类标识。
void	insertComponent(Component c) 将一个组件插入到文档中，作为当前选定内容的替换。
void	insertIcon(Icon g) 将一个图标插入到文档中，作为当前选定内容的替换。
protected String	paramString() 返回该 JTextPane字符串表示形式。
void	removeStyle(String nm) 删除命名的非 null风格以前添加到文档。
void	replaceSelection(String content) 将当前选定的内容替换为由给定的字符串表示的新内容。
void	setCharacterAttributes(AttributeSet attr, boolean replace) 将给定的属性应用于字符内容。
void	setDocument(Document doc) 将编辑器与文本文档关联。
void	setEditorKit(EditorKit kit) 设置当前已安装的处理内容的工具包。
void	setLogicalStyle(Style s) 设置用于段落在当前插入符号位置的逻辑风格。
void	setParagraphAttributes(AttributeSet attr, boolean replace) 将给定的属性应用到段落。
void	setStyledDocument(StyledDocument doc) 将编辑器与文本文档关联。

Methods inherited from class javax.swing.JEditorPane

addHyperlinkListener, createEditorKitForContentType, fireHyperlinkUpdate, getAccessibleContext, getContentType, getEditorKit, getEditorKitClassNameForContentType, getEditorKitForContentType, getHyperlinkListeners, getPage, getPreferredSize, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getStream, getText, read, registerEditorKitForContentType, registerEditorKitForContentType, removeHyperlinkListener, scrollToReference, setContentType, setEditorKitForContentType, setPage, setPage, setText

Methods inherited from class javax.swing.text.JTextComponent

addCaretListener, addInputMethodListener, addKeymap, copy, cut, fireCaretUpdate, getActions, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getPrintable, getScrollableBlockIncrement, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, moveCaretPosition, paste, print, print, print, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setUI, updateUI, viewToModel, write

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, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, 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

Constructor Detail

JTextPane

public JTextPane()

创建一个新的 JTextPane。 StyledEditorKit的新实例被创建和设置，以及文档模型设置为 null。

JTextPane

public JTextPane(StyledDocument doc)

创建一个新的 JTextPane，用指定的文档模型。 javax.swing.text.StyledEditorKit的新实例被创建和设置。

参数

doc -文档模型

方法详细信息

getUIClassID

public String getUIClassID()

返回用户界面的类标识。

重写：

getUIClassID 方法重写，继承类 JEditorPane

结果

字符串“textpaneui”

另请参见：

JComponent.getUIClassID()， UIDefaults.getUI(javax.swing.JComponent)

setDocument

public void setDocument(Document doc)

将编辑器与文本文档关联。这必须是一个 StyledDocument。

重写：

setDocument 方法重写，继承类 JTextComponent

参数

doc -文档显示/编辑

异常

IllegalArgumentException -如果 doc不能缩小到一个 StyledDocument是所需类型的模型，这个文本组件

另请参见：

JTextComponent.getDocument()

setStyledDocument

public void setStyledDocument(StyledDocument doc)

将编辑器与文本文档关联。当前注册的工厂用于为文档创建一个视图，该视图由编辑器显示。

参数

doc -文档显示/编辑

getStyledDocument

public StyledDocument getStyledDocument()

与编辑相关的模型。

结果

模型

replaceSelection

public void replaceSelection(String content)

将当前选定的内容替换为由给定的字符串表示的新内容。如果没有选择，这相当于给定文本的插入。如果没有替换文本，这相当于当前选择的删除。替换文本将有当前被定义为在插入点输入的属性。如果文件是不可编辑的，嘟嘟和回报。

重写：

replaceSelection 方法重写，继承类 JEditorPane

参数

content -内容替代选择

insertComponent

public void insertComponent(Component c)

将一个组件插入到文档中，作为当前选定内容的替换。如果没有选择的成分是有效的在当前位置插入符号。这是表示在关联的文档中作为内容的一个字符的属性。

该组件是由文本窗格使用的实际成分。由于组件不能是一个以上的容器的子容器，该方法不应该在模型由文本组件共享的情况下使用该方法。

元件放置相对于文本基线根据返回的值Component.getAlignmentY，Swing组件的值可以方便的设置使用方法JComponent.setAlignmentY。例如，设定值0.75将导致组件百分之75是基线以上，和百分之25的分量要低于基线。

参数

c -插入元件

insertIcon

public void insertIcon(Icon g)

将一个图标插入到文档中，作为当前选定内容的替换。如果没有选择的图标是有效的在当前位置插入符号。这是表示在关联的文档中作为内容的一个字符的属性。

参数

g -图标插入

另请参见：

Icon

addStyle

public Style addStyle(String nm,
                      Style parent)

在逻辑样式层次结构中添加一个新样式。样式属性从下向上解决，所以子中指定的属性将覆盖父中指定的属性。

参数

nm -该样式的名称（必须命名风格的集合中是唯一的）。这个名字可能是 null如果风格命名，但对方负责管理引用一位不愿透露姓名的风格不能取的名字返回。一位不愿透露姓名的风格可能像字符属性重写如风格运行发现是有用的。

parent -父样式。这可能是 null如果未指定的属性不需要一些其他的方式解决。

结果

新 Style

removeStyle

public void removeStyle(String nm)

删除命名的非 null风格以前添加到文档。

参数

nm -风格的名字删除

getStyle

public Style getStyle(String nm)

获取一个名叫非 null风格以前添加的。

参数

nm -样式的名称

结果

的 Style

setLogicalStyle

public void setLogicalStyle(Style s)

设置用于段落在当前插入符号位置的逻辑风格。如果属性没有显式设置字符和段落属性，他们将通过分配给该段的逻辑样式来解析，在术语中，可以通过一些完全独立于文档中元素层次结构的层次结构来解决这些问题。

参数

s -指定段落的逻辑风格，或 null没有风格

getLogicalStyle

public Style getLogicalStyle()

获取指定的插入当前位置为代表的段落的逻辑风格，或 null。

结果

的 Style

getCharacterAttributes

public AttributeSet getCharacterAttributes()

引进效果的人物属性在插入当前位置，或 null。

结果

属性，或 null

setCharacterAttributes

public void setCharacterAttributes(AttributeSet attr,
                                   boolean replace)

将给定的属性应用于字符内容。如果有一个选择，属性将被应用到选择范围。如果没有选择，属性被应用到输入属性集，它定义了获取插入的任何新文本的属性。

参数

attr -属性

replace -如果是真的，然后替换现有的属性

getParagraphAttributes

public AttributeSet getParagraphAttributes()

获取当前影响段落属性在插入符号的位置，或 null如果没有。

结果

属性

setParagraphAttributes

public void setParagraphAttributes(AttributeSet attr,
                                   boolean replace)

将给定的属性应用到段落。如果有一个选择，则将属性应用到与选择相交的段落中。如果没有选择，该属性在当前插入符号位置应用于段落。

参数

attr -非 null属性

replace -如果属实，取代现有的属性

getInputAttributes

public MutableAttributeSet getInputAttributes()

获取窗格的输入属性。

结果

属性

getStyledEditorKit

protected final StyledEditorKit getStyledEditorKit()

获取编辑器工具包。

结果

编辑工具

createDefaultEditorKit

protected EditorKit createDefaultEditorKit()

创建 EditorKit默认使用的。这是实现返回 javax.swing.text.StyledEditorKit。

重写：

createDefaultEditorKit 方法重写，继承类 JEditorPane

结果

编辑工具

setEditorKit

public final void setEditorKit(EditorKit kit)

设置当前已安装的处理内容的工具包。这是建立编辑器的内容类型的绑定属性。

重写：

setEditorKit 方法重写，继承类 JEditorPane

参数

kit -所需的编辑行为

异常

IllegalArgumentException -如果不是 StyledEditorKit试剂盒

另请参见：

JEditorPane.getEditorKit()

paramString

protected String paramString()

这 JTextPane返回字符串表示。该方法旨在将只用于调试目的，其含量和返回的字符串格式不同的实现可能会有所不同。返回的字符串是空的但可能不 null。

重写：

paramString 方法重写，继承类 JEditorPane

结果

这 JTextPane字符串表示形式