JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.text
接口 AbstractDocument.Content

所有已知实现类:
GapContent, StringContent
正在封闭类:
AbstractDocument

public static interface AbstractDocument.Content

描述可编辑的字符序列内容的接口。各个实现不一定支持历史机制,历史机制可通过变化是否返回 UndoableEdit 实现反映出来。

另请参见:
AbstractDocument

方法摘要
 Position createPosition(int offset)
          在内容中创建一个位置,该位置将在内容改变时跟踪更改。
 void getChars(int where, int len, Segment txt)
          获得字符序列并将其复制到 Segment 中。
 String getString(int where, int len)
          获取序列中包含的字符串。
 UndoableEdit insertString(int where, String str)
          向序列中插入一个字符串。
 int length()
          当前字符序列内容的长度。
 UndoableEdit remove(int where, int nitems)
          移除该序列的某一部分。
 

方法详细信息

createPosition

Position createPosition(int offset)
                        throws BadLocationException
在内容中创建一个位置,该位置将在内容改变时跟踪更改。

参数:
offset - 内容中的偏移量,该偏移量 >= 0
返回:
一个 Position
抛出:
BadLocationException - 如果 offset 无效

length

int length()
当前字符序列内容的长度。

返回:
长度,该长度 >= 0

insertString

UndoableEdit insertString(int where,
                          String str)
                          throws BadLocationException
向序列中插入一个字符串。

参数:
where - 序列中插入位置的偏移量,该偏移量 >= 0
str - 要插入的字符串
返回:
如果该实现支持历史机制,则返回对 Edit 实现的引用,否则返回 null
抛出:
BadLocationException - 如果参数所覆盖的区域不包含在字符序列中

remove

UndoableEdit remove(int where,
                    int nitems)
                    throws BadLocationException
移除该序列的某一部分。

参数:
where - 序列中插入位置的偏移量,该偏移量 >= 0。
nitems - 序列中要移除的条目数量,该数量 >= 0。
返回:
如果该实现支持历史机制,则返回对 Edit 实现的引用,否则返回 null。
抛出:
BadLocationException - 如果参数所覆盖的区域不包含在字符序列中。

getString

String getString(int where,
                 int len)
                 throws BadLocationException
获取序列中包含的字符串。

参数:
where - 要获取的序列中的 Offset,该 Offset >= 0。
len - 要复制的字符的数量,该数量 >= 0。
返回:
字符串
抛出:
BadLocationException - 如果参数所覆盖的区域不包含在字符序列中。

getChars

void getChars(int where,
              int len,
              Segment txt)
              throws BadLocationException
获得字符序列并将其复制到 Segment 中。

参数:
where - 起始偏移量,该偏移量 >= 0
len - 字符的数量,该数量 >= 0
txt - 将内容复制到的目标位置
抛出:
BadLocationException - 如果参数所覆盖的区域不包含在字符序列中。

JavaTM 2 Platform
Standard Ed. 5.0

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

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