JavaTM Platform
Standard Ed. 6

javax.swing.text
类 DefaultEditorKit

java.lang.Object
  继承者 javax.swing.text.EditorKit
      继承者 javax.swing.text.DefaultEditorKit
所有已实现的接口:
Serializable, Cloneable
直接已知子类:
StyledEditorKit

public class DefaultEditorKit
     
extends EditorKit

这是文本组件使编辑器对某些类型 的文本文档合理发挥其作用所需的实现集合。此实现提供了一个默认实现,该默认实现把文本当作纯文本,并提供简单编辑器的最小操作集合。

换行
有两个属性负责处理换行。系统属性 line.separator,它的定义是和平台相关的,可以是 "\n"、"\r" 或 "\r\n"。还有一个属性,它是在 DefaultEditorKit 中定义的,名称为 EndOfLineStringProperty,它是在文档加载时自动定义的,定义为第一个出现的任意换行符。加载文档后,将会适当地设置 EndOfLineStringProperty,当文档被写回时,将用到 EndOfLineStringProperty。但是当文档在内存中时,无论文档在磁盘上如何定义换行,现在都将用 "\n" 字符定义换行。因此,为便于搜索,要经常使用 "\n"。当创建了新文档而 EndOfLineStringProperty 尚未定义时,写入文档将使用 System 属性。

注意,在 Document 上使用 get/setProperty 方法设置 EndOfLineStringProperty。子类可重写此行为。


嵌套类摘要
static class DefaultEditorKit.BeepAction
          创建蜂鸣声。
static class DefaultEditorKit.CopyAction
          复制选定的区域并将其内容放入系统剪贴板中。
static class DefaultEditorKit.CutAction
          剪切选定的区域并将其内容放入系统剪贴板中。
static class DefaultEditorKit.DefaultKeyTypedAction
          如果接收到键输入事件 并且无 keymap 输入,则默认执行该动作。
static class DefaultEditorKit.InsertBreakAction
          在文档中放置行/段落中断。
static class DefaultEditorKit.InsertContentAction
          将内容置于关联的文档中。
static class DefaultEditorKit.InsertTabAction
          将一个制表符置于文档中。
static class DefaultEditorKit.PasteAction
          将系统剪贴板内容粘贴到选定区域,如果未选中任何内容,则粘贴到插入符前面。
 
字段摘要
static String backwardAction
          用于将插入符在逻辑上向后移动一个位置的动作名称。
static String beepAction
          用于创建蜂鸣声的动作名称。
static String beginAction
          用于将插入符移动到文档开头的 Action 名称。
static String beginLineAction
          用于将插入符移动到行首的 Action 名称。
static String beginParagraphAction
          用于将插入符移动到段落开头的 Action 名称。
static String beginWordAction
          用于将插入符移动到字首的 Action 名称。
static String copyAction
          复制选定区域并将其内容置于剪贴板中的动作名称。
static String cutAction
          剪切选定区域并将其内容置于剪贴板中的动作名称。
static String defaultKeyTypedAction
          在接收到键输入事件 并且无 keymap 输入时默认执行的动作名称。
static String deleteNextCharAction
          删除当前插入符位置之后字符内容的动作名称。
static String deleteNextWordAction
          删除选择开始位置之后单词的动作名称。
static String deletePrevCharAction
          删除当前插入符位置之前字符内容的动作名称。
static String deletePrevWordAction
          删除选择开始位置之前单词的动作名称。
static String downAction
          用于将插入符在逻辑上向下移动一个位置的动作名称。
static String endAction
          用于将插入符移动到文档末尾的 Action 名称。
static String endLineAction
          用于将插入符移动到行尾的 Action 名称。
static String EndOfLineStringProperty
          在读取文档时,如果遇到 CRLF,将添加具有此名称的一个属性,属性值为 "\r\n"。
static String endParagraphAction
          用于将插入符移动到段落末尾的 Action 名称。
static String endWordAction
          用于将插入符移动到字尾的动作名称。
static String forwardAction
          用于将插入符逻辑向前移动一个位置的动作名称。
static String insertBreakAction
          向文档放置行/段中断的动作名称。
static String insertContentAction
          将内容置于关联文档中的动作名称。
static String insertTabAction
          将制表符置于文档中的动作名称。
static String nextWordAction
          用于将插入符移动到下一个字开头的 Action 名称。
static String pageDownAction
          垂直向下翻页的动作名称。
static String pageUpAction
          垂直向上翻页的动作名称。
static String pasteAction
          将系统剪贴板内容粘贴到选定区域、如果未选中任何内容,则粘贴到插入符之前的动作名称。
static String previousWordAction
          用于将插入符移动到前一个字开头的 Action 名称。
static String readOnlyAction
          将编辑器设置为只读模式的动作名称。
static String selectAllAction
          用于选中整个文档的动作名称
static String selectionBackwardAction
          通过将插入符在逻辑上向后移动一个位置来扩展选定内容的动作名称。
static String selectionBeginAction
          用于将插入符移动到文档开头的 Action 名称。
static String selectionBeginLineAction
          用于将插入符移动到行首并扩展选定内容的 Action 名称。
static String selectionBeginParagraphAction
          用于将插入符移动到段落开头并扩展选定内容的 Action 名称。
static String selectionBeginWordAction
          用于将插入符移动到字首并扩展选定内容的 Action 名称。
static String selectionDownAction
          用于将插入符在逻辑上向下移动一个位置并扩展选定内容的动作名称。
static String selectionEndAction
          用于将插入符移动到文档末尾的 Action 名称。
static String selectionEndLineAction
          用于将插入符移动到行尾并扩展选定内容的 Action 名称。
static String selectionEndParagraphAction
          用于将插入符移动到段落末尾并扩展选定内容的 Action 名称。
static String selectionEndWordAction
          用于将插入符移动到字尾并扩展选定内容的动作名称。
static String selectionForwardAction
          通过将插入符在逻辑上向前移动一个位置来扩展选定内容的动作名称。
static String selectionNextWordAction
          用于将选定内容移动到下一个字的开头并扩展选定内容的 Action 名称。
static String selectionPreviousWordAction
          用于将选定内容移动到前一个字的开头并扩展选定内容的 Action 名称。
static String selectionUpAction
          用于将插入符在逻辑上向上移动一个位置并扩展选定内容的动作名称。
static String selectLineAction
          用于选中围绕插入符的某一行的 Action 名称。
static String selectParagraphAction
          用于选中围绕插入符的一个段落的动作名称。
static String selectWordAction
          用于选中围绕插入符的某个字的 Action 名称。
static String upAction
          用于将插入符在逻辑上向上移动一个位置的动作名称。
static String writableAction
          将编辑器设置为可写入模式的动作名称。
 
构造方法摘要
DefaultEditorKit()
          DefaultEditorKit 的默认构造方法
 
方法摘要
 Caret createCaret()
          获取能在由关联的 ViewFactory 生成的视图中导航的插入符。
 Document createDefaultDocument()
          创建一个适合此编辑器类型的未初始化文本存储模型 (PlainDocument)。
 Action[] getActions()
          获取能在文本组件上使用的一组命令,该文本组件使用由此工具包生成的模型和视图。
 String getContentType()
          获取此工具包声明支持的数据的 MIME 类型。
 ViewFactory getViewFactory()
          获取一个适合供由此包所产生的任何模型来产生视图的工厂。
 void read(InputStream in, Document doc, int pos)
          插入取自给定流的内容,其格式需要适合此类型的内容处理程序。
 void read(Reader in, Document doc, int pos)
          插入取自给定流的内容,它将被视为纯文本。
 void write(OutputStream out, Document doc, int pos, int len)
          将文档中的内容以适合此类型内容处理程序的格式写入给定的流。
 void write(Writer out, Document doc, int pos, int len)
          将取自文档的内容以纯文本格式写入给定流。
 
从类 javax.swing.text.EditorKit 继承的方法
clone, deinstall, install
 
从类 java.lang.Object 继承的方法
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

EndOfLineStringProperty

public static final String EndOfLineStringProperty
在读取文档时,如果遇到 CRLF,将添加具有此名称的一个属性,属性值为 "\r\n"。

另请参见:
常量字段值

insertContentAction

public static final String insertContentAction
将内容置于关联文档中的动作名称。如果存在选定内容,则在添加新内容之前将移除这些选定内容。

另请参见:
getActions(), 常量字段值

insertBreakAction

public static final String insertBreakAction
向文档放置行/段中断的动作名称。如果存在选定内容,则在添加中断之前将移除这些选定内容。

另请参见:
getActions(), 常量字段值

insertTabAction

public static final String insertTabAction
将制表符置于文档中的动作名称。如果存在选定内容,则在添加制表符之前将移除这些选定内容。

另请参见:
getActions(), 常量字段值

deletePrevCharAction

public static final String deletePrevCharAction
删除当前插入符位置之前字符内容的动作名称。

另请参见:
getActions(), 常量字段值

deleteNextCharAction

public static final String deleteNextCharAction
删除当前插入符位置之后字符内容的动作名称。

另请参见:
getActions(), 常量字段值

deleteNextWordAction

public static final String deleteNextWordAction
删除选择开始位置之后单词的动作名称。

从以下版本开始:
1.6
另请参见:
getActions(), JTextComponent.getSelectionStart(), 常量字段值

deletePrevWordAction

public static final String deletePrevWordAction
删除选择开始位置之前单词的动作名称。

从以下版本开始:
1.6
另请参见:
getActions(), JTextComponent.getSelectionStart(), 常量字段值

readOnlyAction

public static final String readOnlyAction
将编辑器设置为只读模式的动作名称。

另请参见:
getActions(), 常量字段值

writableAction

public static final String writableAction
将编辑器设置为可写入模式的动作名称。

另请参见:
getActions(), 常量字段值

cutAction

public static final String cutAction
剪切选定区域并将其内容置于剪贴板中的动作名称。

另请参见:
JTextComponent.cut(), getActions(), 常量字段值

copyAction

public static final String copyAction
复制选定区域并将其内容置于剪贴板中的动作名称。

另请参见:
JTextComponent.copy(), getActions(), 常量字段值

pasteAction

public static final String pasteAction
将系统剪贴板内容粘贴到选定区域、如果未选中任何内容,则粘贴到插入符之前的动作名称。

另请参见:
JTextComponent.paste(), getActions(), 常量字段值

beepAction

public static final String beepAction
用于创建蜂鸣声的动作名称。

另请参见:
getActions(), 常量字段值

pageUpAction

public static final String pageUpAction
垂直向上翻页的动作名称。

另请参见:
getActions(), 常量字段值

pageDownAction

public static final String pageDownAction
垂直向下翻页的动作名称。

另请参见:
getActions(), 常量字段值

forwardAction

public static final String forwardAction
用于将插入符逻辑向前移动一个位置的动作名称。

另请参见:
getActions(), 常量字段值

backwardAction

public static final String backwardAction
用于将插入符在逻辑上向后移动一个位置的动作名称。

另请参见:
getActions(), 常量字段值

selectionForwardAction

public static final String selectionForwardAction
通过将插入符在逻辑上向前移动一个位置来扩展选定内容的动作名称。

另请参见:
getActions(), 常量字段值

selectionBackwardAction

public static final String selectionBackwardAction
通过将插入符在逻辑上向后移动一个位置来扩展选定内容的动作名称。

另请参见:
getActions(), 常量字段值

upAction

public static final String upAction
用于将插入符在逻辑上向上移动一个位置的动作名称。

另请参见:
getActions(), 常量字段值

downAction

public static final String downAction
用于将插入符在逻辑上向下移动一个位置的动作名称。

另请参见:
getActions(), 常量字段值

selectionUpAction

public static final String selectionUpAction
用于将插入符在逻辑上向上移动一个位置并扩展选定内容的动作名称。

另请参见:
getActions(), 常量字段值

selectionDownAction

public static final String selectionDownAction
用于将插入符在逻辑上向下移动一个位置并扩展选定内容的动作名称。

另请参见:
getActions(), 常量字段值

beginWordAction

public static final String beginWordAction
用于将插入符移动到字首的 Action 名称。

另请参见:
getActions(), 常量字段值

endWordAction

public static final String endWordAction
用于将插入符移动到字尾的动作名称。

另请参见:
getActions(), 常量字段值

selectionBeginWordAction

public static final String selectionBeginWordAction
用于将插入符移动到字首并扩展选定内容的 Action 名称。

另请参见:
getActions(), 常量字段值

selectionEndWordAction

public static final String selectionEndWordAction
用于将插入符移动到字尾并扩展选定内容的动作名称。

另请参见:
getActions(), 常量字段值

previousWordAction

public static final String previousWordAction
用于将插入符移动到前一个字开头的 Action 名称。

另请参见:
getActions(), 常量字段值

nextWordAction

public static final String nextWordAction
用于将插入符移动到下一个字开头的 Action 名称。

另请参见:
getActions(), 常量字段值

selectionPreviousWordAction

public static final String selectionPreviousWordAction
用于将选定内容移动到前一个字的开头并扩展选定内容的 Action 名称。

另请参见:
getActions(), 常量字段值

selectionNextWordAction

public static final String selectionNextWordAction
用于将选定内容移动到下一个字的开头并扩展选定内容的 Action 名称。

另请参见:
getActions(), 常量字段值

beginLineAction

public static final String beginLineAction
用于将插入符移动到行首的 Action 名称。

另请参见:
getActions(), 常量字段值

endLineAction

public static final String endLineAction
用于将插入符移动到行尾的 Action 名称。

另请参见:
getActions(), 常量字段值

selectionBeginLineAction

public static final String selectionBeginLineAction
用于将插入符移动到行首并扩展选定内容的 Action 名称。

另请参见:
getActions(), 常量字段值

selectionEndLineAction

public static final String selectionEndLineAction
用于将插入符移动到行尾并扩展选定内容的 Action 名称。

另请参见:
getActions(), 常量字段值

beginParagraphAction

public static final String beginParagraphAction
用于将插入符移动到段落开头的 Action 名称。

另请参见:
getActions(), 常量字段值

endParagraphAction

public static final String endParagraphAction
用于将插入符移动到段落末尾的 Action 名称。

另请参见:
getActions(), 常量字段值

selectionBeginParagraphAction

public static final String selectionBeginParagraphAction
用于将插入符移动到段落开头并扩展选定内容的 Action 名称。

另请参见:
getActions(), 常量字段值

selectionEndParagraphAction

public static final String selectionEndParagraphAction
用于将插入符移动到段落末尾并扩展选定内容的 Action 名称。

另请参见:
getActions(), 常量字段值

beginAction

public static final String beginAction
用于将插入符移动到文档开头的 Action 名称。

另请参见:
getActions(), 常量字段值

endAction

public static final String endAction
用于将插入符移动到文档末尾的 Action 名称。

另请参见:
getActions(), 常量字段值

selectionBeginAction

public static final String selectionBeginAction
用于将插入符移动到文档开头的 Action 名称。

另请参见:
getActions(), 常量字段值

selectionEndAction

public static final String selectionEndAction
用于将插入符移动到文档末尾的 Action 名称。

另请参见:
getActions(), 常量字段值

selectWordAction

public static final String selectWordAction
用于选中围绕插入符的某个字的 Action 名称。

另请参见:
getActions(), 常量字段值

selectLineAction

public static final String selectLineAction
用于选中围绕插入符的某一行的 Action 名称。

另请参见:
getActions(), 常量字段值

selectParagraphAction

public static final String selectParagraphAction
用于选中围绕插入符的一个段落的动作名称。

另请参见:
getActions(), 常量字段值

selectAllAction

public static final String selectAllAction
用于选中整个文档的动作名称

另请参见:
getActions(), 常量字段值

defaultKeyTypedAction

public static final String defaultKeyTypedAction
在接收到 键输入事件 并且无 keymap 输入时默认执行的动作名称。

另请参见:
getActions(), 常量字段值
构造方法详细信息

DefaultEditorKit

public DefaultEditorKit()
DefaultEditorKit 的默认构造方法

方法详细信息

getContentType

public String getContentType()
获取此工具包声明支持的数据的 MIME 类型。默认类型为 text/plain

指定者:
EditorKit 中的 getContentType
返回:
类型

getViewFactory

public ViewFactory getViewFactory()
获取一个适合供由此包所产生的任何模型来产生视图的工厂。默认情况下,让 UI 生成此工厂,所以此方法无实现。

指定者:
EditorKit 中的 getViewFactory
返回:
视图工厂

getActions

public Action[] getActions()
获取能在文本组件上使用的一组命令,该文本组件使用由此工具包生成的模型和视图。

指定者:
EditorKit 中的 getActions
返回:
命令列表

createCaret

public Caret createCaret()
获取能在由关联的 ViewFactory 生成的视图中导航的插入符。

指定者:
EditorKit 中的 createCaret
返回:
插入符

createDefaultDocument

public Document createDefaultDocument()
创建一个适合此编辑器类型的未初始化文本存储模型 (PlainDocument)。

指定者:
EditorKit 中的 createDefaultDocument
返回:
模型

read

public void read(InputStream in,
                 Document doc,
                 int pos)
          throws IOException,
                 BadLocationException
插入取自给定流的内容,其格式需要适合此类型的内容处理程序。

指定者:
EditorKit 中的 read
参数:
in - 要读入的流
doc - 插入到的目标文档。
pos - 文档中放入内容的位置,该位置 >= 0。
抛出:
IOException - 如果有任何 I/O 错误
BadLocationException - 如果 pos 代表文档中的无效位置。

write

public void write(OutputStream out,
                  Document doc,
                  int pos,
                  int len)
           throws IOException,
                  BadLocationException
将文档中的内容以适合此类型内容处理程序的格式写入给定的流。

指定者:
EditorKit 中的 write
参数:
out - 要写入的流
doc - 写入所用的源文档。
pos - 文档中获取内容的位置,该位置 >= 0。
len - 要写出的量,该写出量 >= 0。
抛出:
IOException - 如果有任何 I/O 错误
BadLocationException - 如果 pos 代表文档中的无效位置。

read

public void read(Reader in,
                 Document doc,
                 int pos)
          throws IOException,
                 BadLocationException
插入取自给定流的内容,它将被视为纯文本。

指定者:
EditorKit 中的 read
参数:
in - 要读入的流
doc - 插入到的目标文档。
pos - 文档中放入内容的位置,该位置 >= 0。
抛出:
IOException - 如果有任何 I/O 错误
BadLocationException - 如果 pos 代表文档中的无效位置。

write

public void write(Writer out,
                  Document doc,
                  int pos,
                  int len)
           throws IOException,
                  BadLocationException
将取自文档的内容以纯文本格式写入给定流。

指定者:
EditorKit 中的 write
参数:
out - 要写入的流
doc - 写入所用的源文档。
pos - 文档中获取内容的位置,该位置 >= 0。
len - 要写入的量,该写入量 >= 0。
抛出:
IOException - 如果有任何 I/O 错误
BadLocationException - 如果 pos 不是位于 0 和文档长度之间。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策