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 - 如果參數所覆寫的區域不包含在字元序列中。