All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.sun.java.swing.JEditorPane

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----com.sun.java.swing.JComponent
                           |
                           +----com.sun.java.swing.text.JTextComponent
                                   |
                                   +----com.sun.java.swing.JEditorPane

public class JEditorPane

extends JTextComponent

The content type that editor is bound to at any given time is determined by the EditorKit currently installed. If the content is set to a new URL, its type is used to determine the EditorKit that should be used to load the content.

For the keyboard keys used by this component in the standard Look and Feel (L&F) renditions, see the JEditorPane key assignments.

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 Swing1.0 applications. It will not be possible to load serialized Swing1.0 objects with future releases of Swing. The JDK1.2 release of Swing will be the compatibility baseline for the serialized form of Swing objects.

JEditorPane()

Constructs a new JEditorPane.

JEditorPane(String)

Creates a JEditorPane based on a string containing a URL specification.

JEditorPane(URL)

Creates a JEditorPane based on a specified URL for input.

addHyperlinkListener(HyperlinkListener)

Adds a hyperlink listener for notification of any changes, for example when a link is selected and entered.

createDefaultEditorKit()

Creates the default editor kit (PlainEditorKit) for when the component is first created.

createEditorKitForContentType(String)

Create a handler for the given type from the default registry of editor kits.

fireHyperlinkUpdate(HyperlinkEvent)

Notifies all listeners that have registered interest for notification on this event type.

getAccessibleContext()

Get the AccessibleContext associated with this JEditorPane.

getContentType()

Gets the type of content that this editor handles.

getEditorKit()

Fetches the currently installed kit for handling content.

getEditorKitForContentType(String)

Fetches the editor kit to use for the given type of content.

getPage()

Gets the current url being displayed.

getScrollableTracksViewportWidth()

Returns true if a viewport should always force the width of this Scrollable to match the width of the viewport.

getUIClassID()

Gets the class ID for the UI.

isManagingFocus()

Turns off tab traversal once focus gained.

registerEditorKitForContentType(String, String)

Establishes the default bindings of type to name.

removeHyperlinkListener(HyperlinkListener)

Removes a hyperlink listener.

setContentType(String)

Sets the type of content that this editor handles.

setEditorKit(EditorKit)

Sets the currently installed kit for handling content.

setEditorKitForContentType(String, EditorKit)

Directly set the editor kit to use for the given type.

setPage(String)

Sets the current url being displayed.

setPage(URL)

Sets the current url being displayed.

 public JEditorPane()

Constructs a new JEditorPane. The document model is set to null.

 public JEditorPane(URL initialPage) throws IOException

Creates a JEditorPane based on a specified URL for input.

Parameters:

initialPage - the URL

Throws: IOException

if the URL is null or cannot be accessed

 public JEditorPane(String url) throws IOException

Creates a JEditorPane based on a string containing a URL specification.

Parameters:

url - the URL

Throws: IOException

if the URL is null or cannot be accessed

 public synchronized void addHyperlinkListener(HyperlinkListener listener)

Adds a hyperlink listener for notification of any changes, for example when a link is selected and entered.

Parameters:

listener - the listener

 public synchronized void removeHyperlinkListener(HyperlinkListener listener)

Removes a hyperlink listener.

Parameters:

listener - the listener

 public void fireHyperlinkUpdate(HyperlinkEvent e)

Notifies all listeners that have registered interest for notification on this event type. This is normally called by the currently installed EditorKit if a content type that supports hyperlinks is currently active and there was activity with a link. The listener list is processed last to first.

Parameters:

e - the event

See Also:

EventListenerList

 public void setPage(URL page) throws IOException

Sets the current url being displayed. The content type of the pane is set, and if the editor kit for the pane is non-null, then a new default document is created and the URL is read into it.

Parameters:

page - the URL of the page

Throws: IOException

for a null or invalid page specification

 public URL getPage()

Gets the current url being displayed. If a URL was not specified in the creation of the document, this will return null, and relative URL's will not be resolved.

Returns:

the URL

 public void setPage(String url) throws IOException

Sets the current url being displayed.

Parameters:

url - the URL for display

Throws: IOException

for a null or invalid URL specification

 public String getUIClassID()

Gets the class ID for the UI.

Returns:

the ID ("EditorPaneUI")

Overrides:

getUIClassID in class JComponent

See Also:

getUIClassID, getUI

 protected EditorKit createDefaultEditorKit()

Creates the default editor kit (PlainEditorKit) for when the component is first created.

Returns:

the editor kit

 public final EditorKit getEditorKit()

Fetches the currently installed kit for handling content. createDefaultEditorKit() is called to set up a default if necessary.

Returns:

the editor kit

 public final String getContentType()

Gets the type of content that this editor handles.

Returns:

the content type, null if no editor kit set

 public final void setContentType(String type)

Sets the type of content that this editor handles. This calls getEditorKitForContentType, and then setEditorKit if an editor kit can be successfully located. This is a convenience method that can be used as an alternative to calling setEditorKit directly.

Parameters:

type - the non-null mime type for the content editing support.

See Also:

getContentType

 public 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. Any old kit is first deinstalled, then if kit is non-null, the new kit is installed, and a default document created for it. A PropertyChange event ("editorKit") is always fired when setEditorKit() is called.

Parameters:

kit - the desired editor behavior.

See Also:

getEditorKit

 public EditorKit getEditorKitForContentType(String type)

Fetches the editor kit to use for the given type of content. This is called when a type is requested that doesn't match the currently installed type. If the component doesn't have an EditorKit registered for the given type, it will try to create an EditorKit from the default EditorKit registry. If that fails, a PlainEditorKit is used on the assumption that all text documents can be represented as plain text.

This method can be reimplemented to use some other kind of type registry. This can be reimplemented to use the Java Activation Framework for example.

Parameters:

type - the non-null content type

Returns:

the editor kit

 public void setEditorKitForContentType(String type,
                                        EditorKit k)

Directly set the editor kit to use for the given type. A look-and-feel implementation might use this in conjunction with createEditorKitForContentType to install handlers for content types with a look-and-feel bias.

Parameters:

type - the non-null content type

k - the editor kit to be set

 public static EditorKit createEditorKitForContentType(String type)

Create a handler for the given type from the default registry of editor kits. The registry is created if necessary. An attempt is made to dynamically load the prototype of the given kit. If successful it is cloned and returned.

Parameters:

type - the content type

Returns:

the editor kit, or null if one cannot be created

 public static void registerEditorKitForContentType(String type,
                                                    String classname)

Establishes the default bindings of type to name. The class will be dynamically loaded later when actually needed, and can be safely changed before attempted uses to avoid loading unwanted classes.

Parameters:

type - the non-null content type

classname - the class to load later

 public boolean isManagingFocus()

Turns off tab traversal once focus gained.

Returns:

true, to indicate that the focus is being managed

Overrides:

isManagingFocus in class JComponent

 public boolean getScrollableTracksViewportWidth()

Returns true if a viewport should always force the width of this Scrollable to match the width of the viewport.

Returns:

true if a viewport should force the Scrollables width to match its own.

Overrides:

getScrollableTracksViewportWidth in class JTextComponent

 public AccessibleContext getAccessibleContext()

Get the AccessibleContext associated with this JEditorPane. A new context is created if necessary.

Returns:

the AccessibleContext of this JEditorPane

Overrides:

getAccessibleContext in class JTextComponent

All Packages  Class Hierarchy  This Package  Previous  Next  Index