Java javax.swing.text 接口 AbstractDocument.Content（JDK5）

所有类

javax.swing.text
接口 AbstractDocument.Content

所有已知实现类：

GapContent, StringContent

正在封闭类：

AbstractDocument

public static interface AbstractDocument.Content

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

另请参见：

AbstractDocument

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 - 如果参数所覆盖的区域不包含在字符序列中。