Module java.desktop

Package javax.swing.text.html

Class HTMLEditorKit.HTMLTextAction

java.lang.Object

javax.swing.AbstractAction

javax.swing.text.TextAction

javax.swing.text.StyledEditorKit.StyledTextAction

javax.swing.text.html.HTMLEditorKit.HTMLTextAction

All Implemented Interfaces:

ActionListener, Serializable, Cloneable, EventListener, Action

Direct Known Subclasses:

HTMLEditorKit.InsertHTMLTextAction

Enclosing class:

HTMLEditorKit

public abstract static class HTMLEditorKit.HTMLTextAction
extends StyledEditorKit.StyledTextAction

An abstract Action providing some convenience methods that may be useful in inserting HTML into an existing document.

NOTE: None of the convenience methods obtain a lock on the document. If you have another thread modifying the text these methods may have inconsistent behavior, or return the wrong thing.

See Also:

Serialized Form

Field Summary

Fields inherited from class javax.swing.AbstractAction

changeSupport, enabled

Fields inherited from interface javax.swing.Action

ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, DISPLAYED_MNEMONIC_INDEX_KEY, LARGE_ICON_KEY, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SELECTED_KEY, SHORT_DESCRIPTION, SMALL_ICON

Constructor Summary

Constructors

Constructor	Description
HTMLTextAction(String name)	Creates a new HTMLTextAction from a string action name.

Method Summary

Modifier and Type	Method	Description
protected int	elementCountToTag(HTMLDocument doc, int offset, HTML.Tag tag)	Returns number of elements, starting at the deepest leaf, needed to get to an element representing tag.
protected Element	findElementMatchingTag(HTMLDocument doc, int offset, HTML.Tag tag)	Returns the deepest element at offset matching tag.
protected Element[]	getElementsAt(HTMLDocument doc, int offset)	Returns an array of the Elements that contain offset.
protected HTMLDocument	getHTMLDocument(JEditorPane e)
protected HTMLEditorKit	getHTMLEditorKit(JEditorPane e)

Methods inherited from class javax.swing.AbstractAction

addPropertyChangeListener, clone, firePropertyChange, getKeys, getPropertyChangeListeners, getValue, isEnabled, putValue, removePropertyChangeListener, setEnabled

Methods inherited from interface javax.swing.Action

accept

Methods inherited from interface java.awt.event.ActionListener

actionPerformed

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from class javax.swing.text.StyledEditorKit.StyledTextAction

getEditor, getStyledDocument, getStyledEditorKit, setCharacterAttributes, setParagraphAttributes

Methods inherited from class javax.swing.text.TextAction

augmentList, getFocusedComponent, getTextComponent

Constructor Detail

HTMLTextAction

public HTMLTextAction(String name)

Creates a new HTMLTextAction from a string action name.

Parameters:

name - the name of the action

Method Detail

getHTMLDocument

protected HTMLDocument getHTMLDocument(JEditorPane e)

Parameters:

e - the JEditorPane

Returns:

HTMLDocument of e.

getHTMLEditorKit

protected HTMLEditorKit getHTMLEditorKit(JEditorPane e)

Parameters:

e - the JEditorPane

Returns:

HTMLEditorKit for e.

getElementsAt

protected Element[] getElementsAt(HTMLDocument doc,
                                  int offset)

Returns an array of the Elements that contain offset. The first elements corresponds to the root.

Parameters:

doc - an instance of HTMLDocument

offset - value of offset

Returns:

an array of the Elements that contain offset

elementCountToTag

protected int elementCountToTag(HTMLDocument doc,
                                int offset,
                                HTML.Tag tag)

Returns number of elements, starting at the deepest leaf, needed to get to an element representing tag. This will return -1 if no elements is found representing tag, or 0 if the parent of the leaf at offset represents tag.

Parameters:

doc - an instance of HTMLDocument

offset - an offset to start from

tag - tag to represent

Returns:

number of elements

findElementMatchingTag

protected Element findElementMatchingTag(HTMLDocument doc,
                                         int offset,
                                         HTML.Tag tag)

Returns the deepest element at offset matching tag.

Parameters:

doc - an instance of HTMLDocument

offset - the specified offset >= 0

tag - an instance of HTML.Tag

Returns:

the deepest element