Interface AbstractDocument.Content
- All Known Implementing Classes:
-
GapContent
,StringContent
- Enclosing class:
- AbstractDocument
public static interface AbstractDocument.Content
Interface to describe a sequence of character content that can be edited. Implementations may or may not support a history mechanism which will be reflected by whether or not mutations return an UndoableEdit implementation.
- See Also:
AbstractDocument
Method Summary
Modifier and Type | Method | Description |
---|---|---|
Position | createPosition(int offset) | Creates a position within the content that will track change as the content is mutated. |
void | getChars(int where,
int len,
Segment txt) | Gets a sequence of characters and copies them into a Segment. |
String | getString(int where,
int len) | Fetches a string of characters contained in the sequence. |
UndoableEdit | insertString(int where,
String str) | Inserts a string of characters into the sequence. |
int | length() | Current length of the sequence of character content. |
UndoableEdit | remove(int where,
int nitems) | Removes some portion of the sequence. |
Method Detail
createPosition
Position createPosition(int offset) throws BadLocationException
Creates a position within the content that will track change as the content is mutated.
- Parameters:
-
offset
- the offset in the content >= 0 - Returns:
- a Position
- Throws:
-
BadLocationException
- for an invalid offset
length
int length()
Current length of the sequence of character content.
- Returns:
- the length >= 0
insertString
UndoableEdit insertString(int where, String str) throws BadLocationException
Inserts a string of characters into the sequence.
- Parameters:
-
where
- offset into the sequence to make the insertion >= 0 -
str
- string to insert - Returns:
- if the implementation supports a history mechanism, a reference to an
Edit
implementation will be returned, otherwise returnsnull
- Throws:
-
BadLocationException
- thrown if the area covered by the arguments is not contained in the character sequence
remove
UndoableEdit remove(int where, int nitems) throws BadLocationException
Removes some portion of the sequence.
- Parameters:
-
where
- The offset into the sequence to make the insertion >= 0. -
nitems
- The number of items in the sequence to remove >= 0. - Returns:
- If the implementation supports a history mechanism, a reference to an Edit implementation will be returned, otherwise null.
- Throws:
-
BadLocationException
- Thrown if the area covered by the arguments is not contained in the character sequence.
getString
String getString(int where, int len) throws BadLocationException
Fetches a string of characters contained in the sequence.
- Parameters:
-
where
- Offset into the sequence to fetch >= 0. -
len
- number of characters to copy >= 0. - Returns:
- the string
- Throws:
-
BadLocationException
- Thrown if the area covered by the arguments is not contained in the character sequence.
getChars
void getChars(int where, int len, Segment txt) throws BadLocationException
Gets a sequence of characters and copies them into a Segment.
- Parameters:
-
where
- the starting offset >= 0 -
len
- the number of characters >= 0 -
txt
- the target location to copy into - Throws:
-
BadLocationException
- Thrown if the area covered by the arguments is not contained in the character sequence.