Класс GapContent

java.lang.Object

javax.swing.text.GapContent

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

public class GapContent extends Object implements AbstractDocument.Content, Serializable

Реализация интерфейса AbstractDocument.Content, использующая буфер с пробелом, аналогичный используемому в emacs. Базовая структура — массив символов Юникода с пробелом в определенной позиции. Пробел перемещается в позицию изменений, чтобы воспользоваться преимуществами типичного поведения, когда большинство изменений происходит в одном месте. Изменения, которые происходят на границе пробела, обычно недороги, а перемещение пробела обычно дешевле, чем непосредственное перемещение содержимого массива для размещения изменений.

Отслеживание изменений также обычно недорогие. Реализации Position (метки) хранят индекс массива и могут легко рассчитать последовательную позицию из текущей позиции пробела. Изменения требуют только обновления меток между старой и новой границами пробела при перемещении пробела, поэтому обновление меток обычно недорогие. Метки хранятся в отсортированном порядке, поэтому их можно быстро найти с помощью двоичного поиска. Это увеличивает затраты на добавление метки и уменьшает затраты на обновление метки.

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

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`allocateArray(int len)`	Выделение массива для хранения элементов соответствующего типа (который определяется подклассом).
`Position`	`createPosition(int offset)`	Создание позиции в содержании, которая будет отслеживать изменения при изменении содержимого.
`protected final Object`	`getArray()`	Доступ к массиву.
`protected int`	`getArrayLength()`	Получение длины выделенного массива.
`void`	`getChars(int where, int len, Segment chars)`	Извлечение части содержимого.
`protected final int`	`getGapEnd()`	Доступ к концу пробела.
`protected final int`	`getGapStart()`	Доступ к началу пробела.
`protected Vector`	`getPositionsInRange(Vector v, int offset, int length)`	Возвращает вектор, содержащий экземпляры 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`	`replace(int position, int rmSize, Object addItems, int addSize)`	Замена заданной логической позиции в хранилище заданными новыми элементами.
`protected void`	`resetMarksAtZero()`	Сброс всех меток, у которых смещение равно 0, чтобы установить и их индекс в ноль.
`protected void`	`shiftEnd(int newSize)`	Увеличение размера пробела, перемещение необходимых данных и обновление соответствующих меток.
`protected void`	`shiftGap(int newGapStart)`	Перемещение начала пробела в новое местоположение без изменения размера пробела.
`protected void`	`shiftGapEndUp(int newGapEnd)`	Корректировка конца пробела вверх.
`protected void`	`shiftGapStartDown(int newGapStart)`	Корректировка конца пробела вниз.
`protected void`	`updateUndoPositions(Vector positions, int offset, int length)`	Сброс местоположения для всех экземпляров UndoPosRef в `positions`.

Методы, унаследованные от класса java.lang.Object

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

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

GapContent

public GapContent()

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

GapContent

public GapContent(int initialLength)

Создаёт новый объект GapContent с указанным начальным размером. Начальный размер не может быть меньше 2, чтобы обеспечить место для подразумеваемого разрыва и промежутка.

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

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

allocateArray

protected Object allocateArray(int len)

Выделяет массив для хранения элементов соответствующего типа (который определяется подклассом).

Параметры:: len - длина массива
Возвращает:: массив Java некоторого типа

getArrayLength

protected int getArrayLength()

Получает длину выделенного массива.

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

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

Удаляет часть содержимого.

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

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

Параметры:

where - начальная позиция >= 0, где + nitems < length()

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

Возвращает:

объект UndoableEdit для отмены

Исключения:

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

См. также:

AbstractDocument.Content.remove(int, int)

getString

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

Извлекает часть содержимого.

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

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

Извлекает часть содержимого. Если нужное содержимое охватывает разрыв, мы копируем содержимое. Если нужное содержимое не охватывает разрыв, возвращается фактическое хранилище, чтобы избежать копирования, так как оно непрерывно.

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

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

Параметры:

where - начальная позиция >= 0, где + len <= length()

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 - если указанная позиция неверна

shiftEnd

protected void shiftEnd(int newSize)

Увеличить разрыв, переместив необходимые данные и обновив соответствующие метки.

Параметры:: newSize - новая ёмкость

shiftGap

protected void shiftGap(int newGapStart)

Переместить начало разрыва в новое местоположение, не изменяя размер разрыва. Это перемещает данные в массиве и обновляет метки соответственно.

Параметры:: newGapStart - новое начало разрыва

resetMarksAtZero

protected void resetMarksAtZero()

Сбрасывает все метки, у которых смещение равно 0, чтобы их индекс также был равен нулю.

shiftGapStartDown

protected void shiftGapStartDown(int newGapStart)

Изменить конец разрыва вниз. Это не перемещает данные, но обновляет любые метки, затронутые изменением границ. Все метки от старого начала разрыва до нового начала разрыва сжимаются до конца разрыва (их местоположение было удалено).

Параметры:: newGapStart - новое начало разрыва

shiftGapEndUp

protected void shiftGapEndUp(int newGapEnd)

Изменить конец разрыва вверх. Это не перемещает данные, но обновляет любые метки, затронутые изменением границ. Все метки от старого конца разрыва до нового конца разрыва сжимаются до конца разрыва (их местоположение было удалено).

Параметры:: newGapEnd - новый конец разрыва

getPositionsInRange

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

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

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

updateUndoPositions

protected void updateUndoPositions(Vector positions, int offset, int length)

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

Предназначено для внутреннего использования и обычно не представляет интереса для подклассов.

Параметры:: positions - экземпляры UndoPosRef для сброса; offset - место вставки строки; length - длина вставленной строки

getArray

protected final Object getArray()

Доступ к массиву. Фактический тип массива известен только подклассу.

Возвращает:: массив Java некоторого типа

getGapStart

protected final int getGapStart()

Доступ к началу разрыва.

Возвращает:: начало разрыва

getGapEnd

protected final int getGapEnd()

Доступ к концу разрыва.

Возвращает:: конец разрыва

replace

protected void replace(int position, int rmSize, Object addItems, int addSize)

Заменяет заданную логическую позицию в хранилище заданными новыми элементами. Это переместит разрыв в область, изменяемую, если разрыв в данный момент не находится в месте изменения.

Параметры:: position - место для замены. Это не место в базовом массиве хранения, а место в непрерывном пространстве, которое моделируется.; rmSize - количество элементов для удаления; addItems - новые элементы для размещения в хранилище.; addSize - количество элементов для добавления

© 1993, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/swing/text/GapContent.html