javax.swing.text
Class EditorKit

java.lang.Object
  |
  +--javax.swing.text.EditorKit
All Implemented Interfaces:
Cloneable, Serializable
Direct Known Subclasses:
DefaultEditorKit

public abstract class EditorKit
extends Object
implements Cloneable, Serializable

Safe:

See Also:
Serialized Form

Constructor Summary
EditorKit()
          Enabled: Construct an EditorKit.
 
Method Summary
 Object clone()
          Suppressed: Creates a copy of the editor kit.
abstract  Caret createCaret()
          Enabled: Fetches a caret that can navigate through views produced by the associated ViewFactory.
abstract  Document createDefaultDocument()
          Enabled: Creates an uninitialized text storage model that is appropriate for this type of editor.
 void deinstall(JEditorPane c)
          Enabled: Called when the kit is being removed from the JEditorPane.
abstract  Action[] getActions()
          Suppressed: Fetches the set of commands that can be used on a text component that is using a model and view produced by this kit.
abstract  String getContentType()
          Enabled: Gets the MIME type of the data that this kit represents support for.
abstract  ViewFactory getViewFactory()
          Enabled: Fetches a factory that is suitable for producing views of any models that are produced by this kit.
 void install(JEditorPane c)
          Enabled: Called when the kit is being installed into the a JEditorPane.
abstract  void read(InputStream in, Document doc, int pos)
          Enabled: Inserts content from the given stream which is expected to be in a format appropriate for this kind of content handler.
abstract  void read(Reader in, Document doc, int pos)
          Enabled: Inserts content from the given stream which is expected to be in a format appropriate for this kind of content handler.
abstract  void write(OutputStream out, Document doc, int pos, int len)
          Enabled: Writes content from a document to the given stream in a format appropriate for this kind of content handler.
abstract  void write(Writer out, Document doc, int pos, int len)
          Enabled: Writes content from a document to the given stream in a format appropriate for this kind of content handler.
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

EditorKit

public EditorKit()
Enabled: Construct an EditorKit.

Method Detail

clone

public Object clone()
Suppressed: Creates a copy of the editor kit. This is implemented to use Object.clone. If the kit cannot be cloned, null is returned.

Overrides:
clone in class Object
Returns:
the copy
See Also:
java.lang.Cloneable

install

public void install(JEditorPane c)
Enabled: Called when the kit is being installed into the a JEditorPane.

Parameters:
c - the JEditorPane

deinstall

public void deinstall(JEditorPane c)
Enabled: Called when the kit is being removed from the JEditorPane. This is used to unregister any listeners that were attached.

Parameters:
c - the JEditorPane

getContentType

public abstract String getContentType()
Enabled: Gets the MIME type of the data that this kit represents support for.

Returns:
the type

getViewFactory

public abstract ViewFactory getViewFactory()
Enabled: Fetches a factory that is suitable for producing views of any models that are produced by this kit.

Returns:
the factory

getActions

public abstract Action[] getActions()
Suppressed: Fetches the set of commands that can be used on a text component that is using a model and view produced by this kit.

Returns:
the set of actions

createCaret

public abstract Caret createCaret()
Enabled: Fetches a caret that can navigate through views produced by the associated ViewFactory.

Returns:
the caret

createDefaultDocument

public abstract Document createDefaultDocument()
Enabled: Creates an uninitialized text storage model that is appropriate for this type of editor.

Returns:
the model

read

public abstract void read(InputStream in,
                          Document doc,
                          int pos)
                   throws IOException,
                          BadLocationException
Enabled: Inserts content from the given stream which is expected to be in a format appropriate for this kind of content handler.

Parameters:
in - The stream to read from
doc - The destination for the insertion.
pos - The location in the document to place the content >= 0.
IOException
BadLocationException

write

public abstract void write(OutputStream out,
                           Document doc,
                           int pos,
                           int len)
                    throws IOException,
                           BadLocationException
Enabled: Writes content from a document to the given stream in a format appropriate for this kind of content handler.

Parameters:
out - The stream to write to
doc - The source for the write.
pos - The location in the document to fetch the content from >= 0.
len - The amount to write out >= 0.
IOException
BadLocationException

read

public abstract void read(Reader in,
                          Document doc,
                          int pos)
                   throws IOException,
                          BadLocationException
Enabled: Inserts content from the given stream which is expected to be in a format appropriate for this kind of content handler.

Since actual text editing is unicode based, this would generally be the preferred way to read in the data. Some types of content are stored in an 8-bit form however, and will favor the InputStream.

Parameters:
in - The stream to read from
doc - The destination for the insertion.
pos - The location in the document to place the content >= 0.
IOException
BadLocationException

write

public abstract void write(Writer out,
                           Document doc,
                           int pos,
                           int len)
                    throws IOException,
                           BadLocationException
Enabled: Writes content from a document to the given stream in a format appropriate for this kind of content handler.

Since actual text editing is unicode based, this would generally be the preferred way to write the data. Some types of content are stored in an 8-bit form however, and will favor the OutputStream.

Parameters:
out - The stream to write to
doc - The source for the write.
pos - The location in the document to fetch the content >= 0.
len - The amount to write out >= 0.
IOException
BadLocationException


comments?