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.text
class DefaultEditorKit

java.lang.Object extended by javax.swing.text.EditorKit extended by javax.swing.text.DefaultEditorKit
All Implemented Interfaces:
Serializable, Cloneable
Direct Known Subclasses:
StyledEditorKit

public class DefaultEditorKit
extends EditorKit

This is the set of things needed by a text component to be a reasonably functioning editor for some type of text document. This implementation provides a default implementation which treats text as plain text and provides a minimal set of actions for a simple editor.

Newlines
There are two properties which deal with newlines. The system property, line.separator, is defined to be platform-dependent, either "\n", "\r", or "\r\n". There is also a property defined in DefaultEditorKit, called EndOfLineStringProperty, which is defined automatically when a document is loaded, to be the first occurrence of any of the newline characters. When a document is loaded, EndOfLineStringProperty is set appropriately, and when the document is written back out, the EndOfLineStringProperty is used. But while the document is in memory, the "\n" character is used to define a newline, regardless of how the newline is defined when the document is on disk. Therefore, for searching purposes, "\n" should always be used. When a new document is created, and the EndOfLineStringProperty has not been defined, it will use the System property when writing out the document.

Note that EndOfLineStringProperty is set on the Document using the get/setProperty methods. Subclasses may override this behavior.


Nested Class Summary
static class

           Creates a beep.
static class

           Copies the selected region and place its contents into the system clipboard.
static class

           Cuts the selected region and place its contents into the system clipboard.
static class

           The action that is executed by default if a key typed event is received and there is no keymap entry.
static class

           Places a line/paragraph break into the document.
static class

           Places content into the associated document.
static class

           Places a tab character into the document.
static class

           Pastes the contents of the system clipboard into the selected region, or before the caret if nothing is selected.
 
Field Summary
static String backwardAction
          Name of the Action for moving the caret logically backward one position.
static String beepAction
          Name of the action to create a beep.
static String beginAction
          Name of the Action for moving the caret to the beginning of the document.
static String beginLineAction
          Name of the Action for moving the caret to the beginning of a line.
static String beginParagraphAction
          Name of the Action for moving the caret to the beginning of a paragraph.
static String beginWordAction
          Name of the Action for moving the caret to the beginning of a word.
static String copyAction
          Name of the action to copy the selected region and place the contents into the system clipboard.
static String cutAction
          Name of the action to cut the selected region and place the contents into the system clipboard.
static String defaultKeyTypedAction
          Name of the action that is executed by default if a key typed event is received and there is no keymap entry.
static String deleteNextCharAction
          Name of the action to delete the character of content that follows the current caret position.
static String deleteNextWordAction
          Name of the action to delete the word that follows the beginning of the selection.
static String deletePrevCharAction
          Name of the action to delete the character of content that precedes the current caret position.
static String deletePrevWordAction
          Name of the action to delete the word that precedes the beginning of the selection.
static String downAction
          Name of the Action for moving the caret logically downward one position.
static String endAction
          Name of the Action for moving the caret to the end of the document.
static String endLineAction
          Name of the Action for moving the caret to the end of a line.
static String EndOfLineStringProperty
          When reading a document if a CRLF is encountered a property with this name is added and the value will be "\r\n".
static String endParagraphAction
          Name of the Action for moving the caret to the end of a paragraph.
static String endWordAction
          Name of the Action for moving the caret to the end of a word.
static String forwardAction
          Name of the Action for moving the caret logically forward one position.
static String insertBreakAction
          Name of the action to place a line/paragraph break into the document.
static String insertContentAction
          Name of the action to place content into the associated document.
static String insertTabAction
          Name of the action to place a tab character into the document.
static String nextWordAction
          Name of the Action for moving the caret to the beginning of the next word.
static String pageDownAction
          Name of the action to page down vertically.
static String pageUpAction
          Name of the action to page up vertically.
static String pasteAction
          Name of the action to paste the contents of the system clipboard into the selected region, or before the caret if nothing is selected.
static String previousWordAction
          Name of the Action for moving the caret to the beginning of the previous word.
static String readOnlyAction
          Name of the action to set the editor into read-only mode.
static String selectAllAction
          Name of the Action for selecting the entire document
static String selectionBackwardAction
          Name of the Action for extending the selection by moving the caret logically backward one position.
static String selectionBeginAction
          Name of the Action for moving the caret to the beginning of the document.
static String selectionBeginLineAction
          Name of the Action for moving the caret to the beginning of a line, extending the selection.
static String selectionBeginParagraphAction
          Name of the Action for moving the caret to the beginning of a paragraph, extending the selection.
static String selectionBeginWordAction
          Name of the Action for moving the caret to the beginning of a word, extending the selection.
static String selectionDownAction
          Name of the Action for moving the caret logically downward one position, extending the selection.
static String selectionEndAction
          Name of the Action for moving the caret to the end of the document.
static String selectionEndLineAction
          Name of the Action for moving the caret to the end of a line, extending the selection.
static String selectionEndParagraphAction
          Name of the Action for moving the caret to the end of a paragraph, extending the selection.
static String selectionEndWordAction
          Name of the Action for moving the caret to the end of a word, extending the selection.
static String selectionForwardAction
          Name of the Action for extending the selection by moving the caret logically forward one position.
static String selectionNextWordAction
          Name of the Action for moving the selection to the beginning of the next word, extending the selection.
static String selectionPreviousWordAction
          Name of the Action for moving the selection to the beginning of the previous word, extending the selection.
static String selectionUpAction
          Name of the Action for moving the caret logically upward one position, extending the selection.
static String selectLineAction
          Name of the Action for selecting a line around the caret.
static String selectParagraphAction
          Name of the Action for selecting a paragraph around the caret.
static String selectWordAction
          Name of the Action for selecting a word around the caret.
static String upAction
          Name of the Action for moving the caret logically upward one position.
static String writableAction
          Name of the action to set the editor into writeable mode.
 
Constructor Summary

          default constructor for DefaultEditorKit
 
Method Summary
 Caret

          Fetches a caret that can navigate through views produced by the associated ViewFactory.
 Document

          Creates an uninitialized text storage model (PlainDocument) that is appropriate for this type of editor.
 Action[]

          Fetches the set of commands that can be used on a text component that is using a model and view produced by this kit.
 String

          Gets the MIME type of the data that this kit represents support for.
 ViewFactory

          Fetches a factory that is suitable for producing views of any models that are produced by this kit.
 void
read(InputStream in, Document doc, int pos)

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

          Inserts content from the given stream, which will be treated as plain text.
 void
write(OutputStream out, Document doc, int pos, int len)

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

          Writes content from a document to the given stream as plain text.
 
Methods inherited from class javax.swing.text.EditorKit
clone, createCaret, createDefaultDocument, deinstall, getActions, getContentType, getViewFactory, install, read, read, write, write
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

backwardAction

public static final String backwardAction
Name of the Action for moving the caret logically backward one position.

beepAction

public static final String beepAction
Name of the action to create a beep.

beginAction

public static final String beginAction
Name of the Action for moving the caret to the beginning of the document.

beginLineAction

public static final String beginLineAction
Name of the Action for moving the caret to the beginning of a line.

beginParagraphAction

public static final String beginParagraphAction
Name of the Action for moving the caret to the beginning of a paragraph.

beginWordAction

public static final String beginWordAction
Name of the Action for moving the caret to the beginning of a word.

copyAction

public static final String copyAction
Name of the action to copy the selected region and place the contents into the system clipboard.

cutAction

public static final String cutAction
Name of the action to cut the selected region and place the contents into the system clipboard.

defaultKeyTypedAction

public static final String defaultKeyTypedAction
Name of the action that is executed by default if a key typed event is received and there is no keymap entry.

deleteNextCharAction

public static final String deleteNextCharAction
Name of the action to delete the character of content that follows the current caret position.

deleteNextWordAction

public static final String deleteNextWordAction
Name of the action to delete the word that follows the beginning of the selection.

deletePrevCharAction

public static final String deletePrevCharAction
Name of the action to delete the character of content that precedes the current caret position.

deletePrevWordAction

public static final String deletePrevWordAction
Name of the action to delete the word that precedes the beginning of the selection.

downAction

public static final String downAction
Name of the Action for moving the caret logically downward one position.

endAction

public static final String endAction
Name of the Action for moving the caret to the end of the document.

endLineAction

public static final String endLineAction
Name of the Action for moving the caret to the end of a line.

EndOfLineStringProperty

public static final String EndOfLineStringProperty
When reading a document if a CRLF is encountered a property with this name is added and the value will be "\r\n".

endParagraphAction

public static final String endParagraphAction
Name of the Action for moving the caret to the end of a paragraph.

endWordAction

public static final String endWordAction
Name of the Action for moving the caret to the end of a word.

forwardAction

public static final String forwardAction
Name of the Action for moving the caret logically forward one position.

insertBreakAction

public static final String insertBreakAction
Name of the action to place a line/paragraph break into the document. If there is a selection, it is removed before the break is added.

insertContentAction

public static final String insertContentAction
Name of the action to place content into the associated document. If there is a selection, it is removed before the new content is added.

insertTabAction

public static final String insertTabAction
Name of the action to place a tab character into the document. If there is a selection, it is removed before the tab is added.

nextWordAction

public static final String nextWordAction
Name of the Action for moving the caret to the beginning of the next word.

pageDownAction

public static final String pageDownAction
Name of the action to page down vertically.

pageUpAction

public static final String pageUpAction
Name of the action to page up vertically.

pasteAction

public static final String pasteAction
Name of the action to paste the contents of the system clipboard into the selected region, or before the caret if nothing is selected.

previousWordAction

public static final String previousWordAction
Name of the Action for moving the caret to the beginning of the previous word.

readOnlyAction

public static final String readOnlyAction
Name of the action to set the editor into read-only mode.

selectAllAction

public static final String selectAllAction
Name of the Action for selecting the entire document

selectionBackwardAction

public static final String selectionBackwardAction
Name of the Action for extending the selection by moving the caret logically backward one position.

selectionBeginAction

public static final String selectionBeginAction
Name of the Action for moving the caret to the beginning of the document.

selectionBeginLineAction

public static final String selectionBeginLineAction
Name of the Action for moving the caret to the beginning of a line, extending the selection.

selectionBeginParagraphAction

public static final String selectionBeginParagraphAction
Name of the Action for moving the caret to the beginning of a paragraph, extending the selection.

selectionBeginWordAction

public static final String selectionBeginWordAction
Name of the Action for moving the caret to the beginning of a word, extending the selection.

selectionDownAction

public static final String selectionDownAction
Name of the Action for moving the caret logically downward one position, extending the selection.

selectionEndAction

public static final String selectionEndAction
Name of the Action for moving the caret to the end of the document.

selectionEndLineAction

public static final String selectionEndLineAction
Name of the Action for moving the caret to the end of a line, extending the selection.

selectionEndParagraphAction

public static final String selectionEndParagraphAction
Name of the Action for moving the caret to the end of a paragraph, extending the selection.

selectionEndWordAction

public static final String selectionEndWordAction
Name of the Action for moving the caret to the end of a word, extending the selection.

selectionForwardAction

public static final String selectionForwardAction
Name of the Action for extending the selection by moving the caret logically forward one position.

selectionNextWordAction

public static final String selectionNextWordAction
Name of the Action for moving the selection to the beginning of the next word, extending the selection.

selectionPreviousWordAction

public static final String selectionPreviousWordAction
Name of the Action for moving the selection to the beginning of the previous word, extending the selection.

selectionUpAction

public static final String selectionUpAction
Name of the Action for moving the caret logically upward one position, extending the selection.

selectLineAction

public static final String selectLineAction
Name of the Action for selecting a line around the caret.

selectParagraphAction

public static final String selectParagraphAction
Name of the Action for selecting a paragraph around the caret.

selectWordAction

public static final String selectWordAction
Name of the Action for selecting a word around the caret.

upAction

public static final String upAction
Name of the Action for moving the caret logically upward one position.

writableAction

public static final String writableAction
Name of the action to set the editor into writeable mode.
Constructor Detail

DefaultEditorKit

public DefaultEditorKit()
default constructor for DefaultEditorKit

Method Detail

createCaret

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

Overrides:
createCaret in class EditorKit
Returns:
the caret

createDefaultDocument

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

Overrides:
createDefaultDocument in class EditorKit
Returns:
the model

getActions

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

Overrides:
getActions in class EditorKit
Returns:
the command list

getContentType

public String getContentType()
Gets the MIME type of the data that this kit represents support for. The default is text/plain.

Overrides:
getContentType in class EditorKit
Returns:
the type

getViewFactory

public ViewFactory getViewFactory()
Fetches a factory that is suitable for producing views of any models that are produced by this kit. The default is to have the UI produce the factory, so this method has no implementation.

Overrides:
getViewFactory in class EditorKit
Returns:
the view factory

read

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

Overrides:
read in class EditorKit
Parameters:
in - The stream to read from
doc - The destination for the insertion.
pos - The location in the document to place the content >= 0.
Throws:
IOException - on any I/O error
BadLocationException - if pos represents an invalid location within the document.

read

public void read(Reader in,
                 Document doc,
                 int pos)
          throws IOException,
                 BadLocationException
Inserts content from the given stream, which will be treated as plain text.

Overrides:
read in class EditorKit
Parameters:
in - The stream to read from
doc - The destination for the insertion.
pos - The location in the document to place the content >= 0.
Throws:
IOException - on any I/O error
BadLocationException - if pos represents an invalid location within the document.

write

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

Overrides:
write in class EditorKit
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.
Throws:
IOException - on any I/O error
BadLocationException - if pos represents an invalid location within the document.

write

public void write(Writer out,
                  Document doc,
                  int pos,
                  int len)
           throws IOException,
                  BadLocationException
Writes content from a document to the given stream as plain text.

Overrides:
write in class EditorKit
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.
Throws:
IOException - on any I/O error
BadLocationException - if pos is not within 0 and the length of the document.


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:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.