Класс DocumentFilter.FilterBypass
java.lang.Object
javax.swing.text.DocumentFilter.FilterBypass
- Вложенный класс:
DocumentFilter
public abstract static class DocumentFilter.FilterBypass extends Object
Используется для обхода обращений к документу при его изменении. Реализации документов, которые поддерживают DocumentFilter, должны предоставить реализацию, которая не будет вызывать DocumentFilter при вызове следующих методов из DocumentFilter.
- С:
- 1.4
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Конструктор для вызова подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
abstract Document |
getDocument() |
Возвращает документ, над которым происходит изменение. |
abstract void |
insertString |
Вставляет указанный текст, минуя DocumentFilter. |
abstract void |
remove |
Удаляет указанный фрагмент текста, минуя DocumentFilter. |
abstract void |
replace |
Удаляет область текста с offset до offset + length, и заменяет её на text. |
Подробное описание конструкторов
FilterBypass
protected FilterBypass()
Конструктор для вызова подклассами.
Подробное описание методов
getDocument
public abstract Document getDocument()
Возвращает документ, над которым происходит изменение.
- Возвращает:
- Документ, над которым будут выполняться операции remove/insertString
remove
public abstract void remove(int offset, int length) throws BadLocationException
Удаляет указанный фрагмент текста, минуя DocumentFilter.
- Параметры:
-
offset- смещение от начала >= 0 -
length- количество символов для удаления >= 0 - Исключение:
-
BadLocationException- какая-то часть диапазона удаления не является допустимой частью документа. Местоположение в исключении - это первая встреченная некорректная позиция.
insertString
public abstract void insertString(int offset, String string, AttributeSet attr) throws BadLocationException
Вставляет указанный текст, минуя DocumentFilter.
- Параметры:
-
offset- смещение в документе для вставки содержимого >= 0. Все позиции, которые отслеживают изменения в или после данной позиции, будут перемещены. -
string- строка для вставки -
attr- атрибуты, которые нужно связать с вставленным содержимым. Может быть null, если атрибутов нет. - Исключение:
-
BadLocationException- заданная позиция вставки не является допустимой позицией в документе
replace
public abstract void replace(int offset, int length, String string, AttributeSet attrs) throws BadLocationException
Удаляет область текста с
offset до offset + length, и заменяет её на text.- Параметры:
-
offset- Позиция в документе -
length- Длина удаляемого текста -
string- Текст для вставки, null означает отсутствие текста для вставки -
attrs- AttributeSet, указывающий атрибуты вставляемого текста, null допустим. - Исключение:
-
BadLocationException- заданная позиция вставки не является допустимой позицией в документе
© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/text/DocumentFilter.FilterBypass.html