Класс StringContent

public final class StringContent
extends Object
implements AbstractDocument.Content, Serializable

Реализация интерфейса AbstractDocument.Content, которая представляет собой прямое (brute force) решение, полезное для относительно небольших документов и/или отладки. Она управляет текстовым содержимым как простым массивом символов. Также она довольно неэффективна.

В целом рекомендуется использовать реализации с буфером разрывов (gap buffer) или таблицей фрагментов (piece table) вместо этой. Этот буфер не масштабируется до больших размеров.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans™ была добавлена в пакет java.beans. Пожалуйста, обратитесь к XMLEncoder.

Подробное описание конструкторов

StringContent

public StringContent()

Создаёт новый объект StringContent. Начальный размер по умолчанию равен 10.

StringContent

public StringContent(int initialLength)

Создаёт новый объект StringContent со заданным начальным размером. Если длина меньше 1, используется размер 1.

Параметры:

initialLength - начальный размер

Подробное описание методов

length

public int length()

Возвращает длину содержимого.

Указано в:

length в интерфейсе AbstractDocument.Content

Возвращает:

длину >= 1

См. также:

AbstractDocument.Content.length()

insertString

public UndoableEdit insertString(int where,
                                 String str)
                          throws BadLocationException

Вставляет строку в содержимое.

Указано в:

insertString в интерфейсе AbstractDocument.Content

Параметры:

where - начальная позиция >= 0 && < length()

str - непустая вставляемая строка

Возвращает:

объект UndoableEdit для отмены операции

Исключения:

BadLocationException - если указанная позиция некорректна

См. также:

AbstractDocument.Content.insertString(int, java.lang.String)

remove

public UndoableEdit remove(int where,
                           int nitems)
                    throws BadLocationException

Удаляет часть содержимого. Где + nitems должно быть меньше длины.

Указано в:

remove в интерфейсе AbstractDocument.Content

Параметры:

where - начальная позиция >= 0

nitems - количество символов для удаления >= 0

Возвращает:

объект UndoableEdit для отмены операции

Исключения:

BadLocationException - если указанная позиция некорректна

См. также:

AbstractDocument.Content.remove(int, int)

getString

public String getString(int where,
                        int len)
                 throws BadLocationException

Возвращает часть содержимого. Где + len должно быть меньше или равно длины.

Указано в:

getString в интерфейсе AbstractDocument.Content

Параметры:

where - начальная позиция >= 0

len - длина для извлечения >= 0

Возвращает:

строка, представляющая содержимое; может быть пустой

Исключения:

BadLocationException - если указанная позиция некорректна

См. также:

AbstractDocument.Content.getString(int, int)

getChars

public void getChars(int where,
                     int len,
                     Segment chars)
              throws BadLocationException

Возвращает часть содержимого. где + len должно быть меньше или равно длины

Указано в:

getChars в интерфейсе AbstractDocument.Content

Параметры:

where - начальная позиция >= 0

len - количество символов для извлечения >= 0

chars - объект Segment для возвращения символов

Исключения:

BadLocationException - если указанная позиция некорректна

См. также:

AbstractDocument.Content.getChars(int, int, javax.swing.text.Segment)

createPosition

public Position createPosition(int offset)
                        throws BadLocationException

Создаёт позицию в содержимом, которая будет отслеживать изменения по мере его модификации.

Указано в:

createPosition в интерфейсе AbstractDocument.Content

Параметры:

offset - смещение для создания позиции >= 0

Возвращает:

позицию

Исключения:

BadLocationException - если указанная позиция некорректна

getPositionsInRange

protected Vector getPositionsInRange(Vector v,
                                     int offset,
                                     int length)

Параметры:

v - вектор для использования; создаётся новый при null

offset - начальное смещение >= 0

length - длина >= 0

Возвращает:

множество экземпляров

updateUndoPositions

protected void updateUndoPositions(Vector positions)

Параметры:

positions - позиции экземпляров