This documentation differs from the official API.
Jadeite adds
extra features to the API including:
variable font sizes,
constructions examples,
placeholders for classes and methods, and auto-generated “See Also” links.
Additionally it
is missing some items found in standard Javadoc documentation, including:
generics type information,
“Deprecated” tags and comments,
“See Also” links,
along with other minor differences.
Please send any questions or feedback to
bam@cs.cmu.edu.
javax.swing
class JTextPane
- All Implemented Interfaces:
- MenuContainer, ImageObserver, Serializable, Accessible, Scrollable, TransferHandler.HasGetTransferHandler
-
Most common way to construct:
-
JTextPane textPane = new JTextPane();
Based on 170 examples
public class JTextPane
extends JEditorPane
A text component that can be marked up with attributes that are
represented graphically.
You can find how-to information and examples of using text panes in
Using Text Components,
a section in The Java Tutorial.
This component models paragraphs
that are composed of runs of character level attributes. Each
paragraph may have a logical style attached to it which contains
the default attributes to use if not overridden by attributes set
on the paragraph or character run. Components and images may
be embedded in the flow of text.
- Newlines
-
For a discussion on how newlines are handled, see
DefaultEditorKit.
Warning: Swing is not thread safe. For more
information see Swing's Threading
Policy.
Warning:
Serialized objects of this class will not be compatible with
future Swing releases. The current serialization support is
appropriate for short term storage or RMI between applications running
the same version of Swing. As of 1.4, support for long term storage
of all JavaBeansTM
has been added to the java.beans
package.
Please see {@link java.beans.XMLEncoder}.
Constructor Summary |
Creates a new JTextPane .
|
Creates a new JTextPane , with a specified document model.
|
Method Summary |
Style |
Adds a new style into the logical style hierarchy.
|
protected EditorKit |
Creates the EditorKit to use by default.
|
AttributeSet |
Fetches the character attributes in effect at the
current location of the caret, or null .
|
MutableAttributeSet |
Gets the input attributes for the pane.
|
Style |
Fetches the logical style assigned to the paragraph represented
by the current position of the caret, or null .
|
AttributeSet |
Fetches the current paragraph attributes in effect
at the location of the caret, or null if none.
|
Style |
Fetches a named non-null style previously added.
|
StyledDocument |
Fetches the model associated with the editor.
|
protected StyledEditorKit |
Gets the editor kit.
|
String |
Returns the class ID for the UI.
|
void |
Inserts a component into the document as a replacement
for the currently selected content.
|
void |
Inserts an icon into the document as a replacement
for the currently selected content.
|
protected String |
Returns a string representation of this JTextPane .
|
void |
Removes a named non-null style previously added to
the document.
|
void |
Replaces the currently selected content with new content
represented by the given string.
|
void |
Applies the given attributes to character
content.
|
void |
Associates the editor with a text document.
|
void |
Sets the currently installed kit for handling
content.
|
void |
Sets the logical style to use for the paragraph at the
current caret position.
|
void |
Applies the given attributes to paragraphs.
|
void |
Associates the editor with a text document.
|
Methods inherited from class javax.swing.JEditorPane |
addHyperlinkListener, createDefaultEditorKit, createEditorKitForContentType, fireHyperlinkUpdate, getAccessibleContext, getContentType, getEditorKit, getEditorKitClassNameForContentType, getEditorKitForContentType, getHyperlinkListeners, getPage, getPreferredSize, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getStream, getText, getUIClassID, paramString, read, registerEditorKitForContentType, registerEditorKitForContentType, removeHyperlinkListener, replaceSelection, scrollToReference, setContentType, setEditorKit, setEditorKitForContentType, setPage, setPage, setText |
Methods inherited from class javax.swing.text.JTextComponent |
addCaretListener, addInputMethodListener, addKeymap, copy, cut, fireCaretUpdate, getAccessibleContext, getActions, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getPrintable, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, moveCaretPosition, paramString, paste, print, print, print, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, replaceSelection, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDocument, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, setUI, updateUI, viewToModel, write |
Methods inherited from class javax.swing.JComponent |
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, 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, 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, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, 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, updateUI |
Methods inherited from class java.awt.Container |
add, add, add, add, add, addContainerListener, addImpl, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree |
Methods inherited from class java.awt.Component |
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
JTextPane
public JTextPane()
-
Creates a new
JTextPane
. A new instance of
StyledEditorKit
is
created and set, and the document model set to null
.
JTextPane
public JTextPane(StyledDocument doc)
-
Creates a new
JTextPane
, with a specified document model.
A new instance of javax.swing.text.StyledEditorKit
is created and set.
- Parameters:
doc
- the document model
addStyle
public Style addStyle(String nm,
Style parent)
-
Adds a new style into the logical style hierarchy. Style attributes
resolve from bottom up so an attribute specified in a child
will override an attribute specified in the parent.
- Parameters:
nm
- the name of the style (must be unique within the
collection of named styles). The name may be null
if the style is unnamed, but the caller is responsible
for managing the reference returned as an unnamed style can't
be fetched by name. An unnamed style may be useful for things
like character attribute overrides such as found in a style
run.
parent
- the parent style. This may be null
if unspecified
attributes need not be resolved in some other style.
- Returns:
- the new
Style
createDefaultEditorKit
protected EditorKit createDefaultEditorKit()
-
Creates the
EditorKit
to use by default. This
is implemented to return javax.swing.text.StyledEditorKit
.
- Overrides:
createDefaultEditorKit
in class JEditorPane
- Returns:
- the editor kit
getCharacterAttributes
public AttributeSet getCharacterAttributes()
-
Fetches the character attributes in effect at the
current location of the caret, or
null
.
- Returns:
- the attributes, or
null
getInputAttributes
public MutableAttributeSet getInputAttributes()
-
Gets the input attributes for the pane.
- Returns:
- the attributes
getLogicalStyle
public Style getLogicalStyle()
-
Fetches the logical style assigned to the paragraph represented
by the current position of the caret, or
null
.
- Returns:
- the
Style
getParagraphAttributes
public AttributeSet getParagraphAttributes()
-
Fetches the current paragraph attributes in effect
at the location of the caret, or
null
if none.
- Returns:
- the attributes
getStyle
public Style getStyle(String nm)
-
Fetches a named non-
null
style previously added.
- Parameters:
nm
- the name of the style
- Returns:
- the
Style
getStyledDocument
public StyledDocument getStyledDocument()
-
Fetches the model associated with the editor.
- Returns:
- the model
getStyledEditorKit
protected final StyledEditorKit getStyledEditorKit()
-
Gets the editor kit.
- Returns:
- the editor kit
getUIClassID
public String getUIClassID()
-
Returns the class ID for the UI.
- Overrides:
getUIClassID
in class JEditorPane
- Returns:
- the string "TextPaneUI"
insertComponent
public void insertComponent(Component c)
-
Inserts a component into the document as a replacement
for the currently selected content. If there is no
selection the component is effectively inserted at the
current position of the caret. This is represented in
the associated document as an attribute of one character
of content.
The component given is the actual component used by the
JTextPane. Since components cannot be a child of more than
one container, this method should not be used in situations
where the model is shared by text components.
The component is placed relative to the text baseline
according to the value returned by
Component.getAlignmentY
. For Swing components
this value can be conveniently set using the method
JComponent.setAlignmentY
. For example, setting
a value of 0.75
will cause 75 percent of the
component to be above the baseline, and 25 percent of the
component to be below the baseline.
This method is thread safe, although most Swing methods
are not. Please see
How
to Use Threads for more information.
- Parameters:
c
- the component to insert
insertIcon
public void insertIcon(Icon g)
-
Inserts an icon into the document as a replacement
for the currently selected content. If there is no
selection the icon is effectively inserted at the
current position of the caret. This is represented in
the associated document as an attribute of one character
of content.
This method is thread safe, although most Swing methods
are not. Please see
How
to Use Threads for more information.
- Parameters:
g
- the icon to insert
paramString
protected String paramString()
-
Returns a string representation of this
JTextPane
.
This method
is intended to be used only for debugging purposes, and the
content and format of the returned string may vary between
implementations. The returned string may be empty but may not
be null
.
- Overrides:
paramString
in class JEditorPane
- Returns:
- a string representation of this
JTextPane
removeStyle
public void removeStyle(String nm)
-
Removes a named non-
null
style previously added to
the document.
- Parameters:
nm
- the name of the style to remove
replaceSelection
public void replaceSelection(String content)
-
Replaces the currently selected content with new content
represented by the given string. If there is no selection
this amounts to an insert of the given text. If there
is no replacement text this amounts to a removal of the
current selection. The replacement text will have the
attributes currently defined for input at the point of
insertion. If the document is not editable, beep and return.
This method is thread safe, although most Swing methods
are not. Please see
How
to Use Threads for more information.
- Overrides:
replaceSelection
in class JEditorPane
- Parameters:
content
- the content to replace the selection with
setCharacterAttributes
public void setCharacterAttributes(AttributeSet attr,
boolean replace)
-
Applies the given attributes to character
content. If there is a selection, the attributes
are applied to the selection range. If there
is no selection, the attributes are applied to
the input attribute set which defines the attributes
for any new text that gets inserted.
This method is thread safe, although most Swing methods
are not. Please see
How
to Use Threads for more information.
- Parameters:
attr
- the attributes
replace
- if true, then replace the existing attributes first
setDocument
public void setDocument(Document doc)
-
Associates the editor with a text document. This
must be a
StyledDocument
.
- Overrides:
setDocument
in class JTextComponent
- Parameters:
doc
- the document to display/edit
setEditorKit
public final void setEditorKit(EditorKit kit)
-
Sets the currently installed kit for handling
content. This is the bound property that
establishes the content type of the editor.
- Overrides:
setEditorKit
in class JEditorPane
- Parameters:
kit
- the desired editor behavior
setLogicalStyle
public void setLogicalStyle(Style s)
-
Sets the logical style to use for the paragraph at the
current caret position. If attributes aren't explicitly set
for character and paragraph attributes they will resolve
through the logical style assigned to the paragraph, which
in term may resolve through some hierarchy completely
independent of the element hierarchy in the document.
This method is thread safe, although most Swing methods
are not. Please see
How
to Use Threads for more information.
- Parameters:
s
- the logical style to assign to the paragraph,
or null
for no style
setParagraphAttributes
public void setParagraphAttributes(AttributeSet attr,
boolean replace)
-
Applies the given attributes to paragraphs. If
there is a selection, the attributes are applied
to the paragraphs that intersect the selection.
If there is no selection, the attributes are applied
to the paragraph at the current caret position.
This method is thread safe, although most Swing methods
are not. Please see
How
to Use Threads for more information.
- Parameters:
attr
- the non-null
attributes
replace
- if true, replace the existing attributes first
setStyledDocument
public void setStyledDocument(StyledDocument doc)
-
Associates the editor with a text document.
The currently registered factory is used to build a view for
the document, which gets displayed by the editor.
- Parameters:
doc
- the document to display/edit
This documentation differs from the official API.
Jadeite adds
extra features to the API including:
variable font sizes,
constructions examples,
placeholders for classes and methods, and auto-generated “See Also” links.
Additionally it
is missing some items found in standard Javadoc documentation, including:
generics type information,
“Deprecated” tags and comments,
“See Also” links,
along with other minor differences.
Please send any questions or feedback to
bam@cs.cmu.edu.
This page displays the
Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
The official Sun™ documentation can be found here at
http://java.sun.com/javase/6/docs/api/.