Класс StringContent

java.lang.Object

javax.swing.text.StringContent

Все реализованные интерфейсы:: Serializable, AbstractDocument.Content

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

Реализация интерфейса AbstractDocument.Content методом грубой силы, подходящая для относительно небольших документов и/или отладки. Содержимое управляется как простой массив символов. Эта реализация также весьма неэффективна.

Обычно рекомендуется вместо неё использовать реализации с буфером промежутка или таблицей фрагментов. Этот буфер не подходит для больших объёмов данных.

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

Краткое описание конструкторов

Конструктор	Описание
`StringContent()`	Создаёт новый объект StringContent.
`StringContent(int initialLength)`	Создаёт новый объект StringContent с указанным начальным размером.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Position`	`createPosition(int offset)`	Создаёт позицию в содержимом, которая будет отслеживать изменения при изменении содержимого.
`void`	`getChars(int where, int len, Segment chars)`	Получает фрагмент содержимого.
`protected Vector`	`getPositionsInRange(Vector v, int offset, int length)`	Возвращает Vector, содержащий экземпляры UndoPosRef для позиций в диапазоне от `offset` до `offset` + `length`.
`String`	`getString(int where, int len)`	Получает фрагмент содержимого.
`UndoableEdit`	`insertString(int where, String str)`	Вставляет строку в содержимое.
`int`	`length()`	Возвращает длину содержимого.
`UndoableEdit`	`remove(int where, int nitems)`	Удаляет часть содержимого.
`protected void`	`updateUndoPositions(Vector positions)`	Сбрасывает расположение всех экземпляров UndoPosRef в `positions`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удалён в будущем выпуске. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.

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

StringContent

public StringContent()

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

StringContent

public StringContent(int initialLength)

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

Параметры:: initialLength — начальный размер

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

length

public int length()

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

Определено в:

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

Возвращает:

длину >= 1

См. также:

insertString

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

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

Определено в:

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

Параметры:

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

str — строка для вставки, не равная null

Возвращает:

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

Исключения:

BadLocationException — если указана недопустимая позиция

См. также:

remove

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

Удаляет часть содержимого. значение where + nitems должно быть < length().

Определено в:

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

Параметры:

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

nitems — число удаляемых символов >= 0

Возвращает:

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

Исключения:

BadLocationException — если указана недопустимая позиция

См. также:

getString

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

Получает фрагмент содержимого. значение where + len должно быть <= length().

Определено в:

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

Параметры:

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

len — длина получаемого фрагмента >= 0

Возвращает:

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

Исключения:

BadLocationException — если указана недопустимая позиция

См. также:

getChars

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

Получает фрагмент содержимого. значение where + len должно быть <= length().

Определено в:

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

Параметры:

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

len — число получаемых символов >= 0

chars — объект Segment, в который будут помещены символы

Исключения:

BadLocationException — если указана недопустимая позиция

См. также:

createPosition

public Position createPosition(int offset) throws BadLocationException

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

Определено в:: createPosition в интерфейсе AbstractDocument.Content
Параметры:: offset — смещение, для которого создаётся позиция >= 0
Возвращает:: позицию
Исключения:: BadLocationException — если указана недопустимая позиция

getPositionsInRange

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

Возвращает Vector, содержащий экземпляры UndoPosRef для позиций в диапазоне от offset до offset + length. Если v не равен null, соответствующие позиции помещаются в него. Возвращается вектор с полученными позициями.

Этот метод предназначен для внутреннего использования и, как правило, не представляет интереса для подклассов.

Параметры:: v — используемый Vector; если он равен null, создаётся новый; offset — начальное смещение >= 0; length — длина >= 0
Возвращает:: набор экземпляров

updateUndoPositions

protected void updateUndoPositions(Vector positions)

Сбрасывает расположение всех экземпляров UndoPosRef в positions.

Параметры:: positions — позиции экземпляров

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.