Класс Utilities

java.lang.Object

javax.swing.text.Utilities

public class Utilities extends Object

Набор методов для выполнения различных операций, связанных с текстом.

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

Конструктор	Описание
`Utilities()`	Создает `Utilities`.

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

Модификатор и тип	Метод	Описание
`static final float`	`drawTabbedText(Segment s, float x, float y, Graphics2D g, TabExpander e, int startOffset)`	Отображает указанный текст, раскрывая все содержащиеся в нем табуляции с помощью заданного способа раскрытия табуляции.
`static final int`	`drawTabbedText(Segment s, int x, int y, Graphics g, TabExpander e, int startOffset)`	Устарел. заменен на `drawTabbedText(Segment, float, float, Graphics2D, TabExpander, int)`
`static final int`	`getBreakLocation(Segment s, FontMetrics metrics, float x0, float x, TabExpander e, int startOffset)`	Определяет место разрыва указанного текста, чтобы он поместился в заданную область.
`static final int`	`getBreakLocation(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset)`	Устарел. заменен на `getBreakLocation(Segment, FontMetrics, float, float, TabExpander, int)`
`static final int`	`getNextWord(JTextComponent c, int offs)`	Определяет начало следующего слова для указанного местоположения.
`static final Element`	`getParagraphElement(JTextComponent c, int offs)`	Определяет элемент, используемый для абзаца/строки.
`static final int`	`getPositionAbove(JTextComponent c, int offs, float x)`	Определяет позицию в модели, ближайшую к указанному местоположению представления в строке выше.
`static final int`	`getPositionAbove(JTextComponent c, int offs, int x)`	Устарел. заменен на `getPositionAbove(JTextComponent, int, float)`
`static final int`	`getPositionBelow(JTextComponent c, int offs, float x)`	Определяет позицию в модели, ближайшую к указанному местоположению представления в строке ниже.
`static final int`	`getPositionBelow(JTextComponent c, int offs, int x)`	Устарел. заменен на `getPositionBelow(JTextComponent, int, float)`
`static final int`	`getPreviousWord(JTextComponent c, int offs)`	Определяет начало предыдущего слова для указанного местоположения.
`static final int`	`getRowEnd(JTextComponent c, int offs)`	Определяет конечную позицию модели строки, содержащей указанную позицию модели.
`static final int`	`getRowStart(JTextComponent c, int offs)`	Определяет начальную позицию модели строки, содержащей указанную позицию модели.
`static final int`	`getTabbedTextOffset(Segment s, FontMetrics metrics, float x0, float x, TabExpander e, int startOffset, boolean round)`	Определяет относительное смещение в указанном тексте, которое наилучшим образом соответствует заданной области в системе координат представления.
`static final int`	`getTabbedTextOffset(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset)`	Устарел. заменен на `getTabbedTextOffset(Segment, FontMetrics, float, float, TabExpander, int, boolean)`
`static final int`	`getTabbedTextOffset(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset, boolean round)`	Устарел. заменен на `getTabbedTextOffset(Segment, FontMetrics, float, float, TabExpander, int, boolean)`
`static final float`	`getTabbedTextWidth(Segment s, FontMetrics metrics, float x, TabExpander e, int startOffset)`	Определяет ширину указанного фрагмента текста с учетом табуляции.
`static final int`	`getTabbedTextWidth(Segment s, FontMetrics metrics, int x, TabExpander e, int startOffset)`	Устарел. заменен на `getTabbedTextWidth(Segment, FontMetrics, float, TabExpander, int)`
`static final int`	`getWordEnd(JTextComponent c, int offs)`	Определяет конец слова для указанного местоположения.
`static final int`	`getWordStart(JTextComponent c, int offs)`	Определяет начало слова для указанного местоположения в модели.

Методы, объявленные в классе 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, либо истечения заданного промежутка реального времени.

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

Utilities

public Utilities()

Создает Utilities.

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

drawTabbedText

@Deprecated(since="9") public static final int drawTabbedText(Segment s, int x, int y, Graphics g, TabExpander e, int startOffset)

Устарел.

заменен на drawTabbedText(Segment, float, float, Graphics2D, TabExpander, int)

Отображает указанный текст, раскрывая все содержащиеся в нем табуляции с помощью заданного способа раскрытия табуляции. Эта реализация использует систему координат в стиле версии 1.1 с целочисленными значениями и разрешением 72 точки на дюйм.

Параметры:: s — источник текста; x — координата X начала >= 0; y — координата Y начала >= 0; g — графический контекст; e — способ раскрытия табуляции. Если значение равно null, табуляция будет заменена пробелом.; startOffset — начальное смещение текста в документе >= 0
Возвращает:: координату X в конце отображенного текста

drawTabbedText

public static final float drawTabbedText(Segment s, float x, float y, Graphics2D g, TabExpander e, int startOffset)

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

Параметры:: s — источник текста; x — координата X начала >= 0; y — координата Y начала >= 0; g — графический контекст; e — способ раскрытия табуляции. Если значение равно null, табуляция будет заменена пробелом.; startOffset — начальное смещение текста в документе >= 0
Возвращает:: координату X в конце отображенного текста
Начиная с:: 9

getTabbedTextWidth

@Deprecated(since="9") public static final int getTabbedTextWidth(Segment s, FontMetrics metrics, int x, TabExpander e, int startOffset)

Устарел.

заменен на getTabbedTextWidth(Segment, FontMetrics, float, TabExpander, int)

Определяет ширину указанного фрагмента текста с учетом табуляции. Реализация использует систему координат в стиле версии 1.1 с целочисленными значениями и разрешением 72 точки на дюйм.

Параметры:: s — источник текста; metrics — метрики шрифта, используемые для вычисления; x — координата X начала >= 0; e — способ раскрытия табуляции. Если значение равно null, табуляция будет заменена пробелом.; startOffset — начальное смещение текста в документе >= 0
Возвращает:: ширину текста

getTabbedTextWidth

public static final float getTabbedTextWidth(Segment s, FontMetrics metrics, float x, TabExpander e, int startOffset)

Определяет ширину указанного фрагмента текста с учетом табуляции.

Параметры:: s — источник текста; metrics — метрики шрифта, используемые для вычисления; x — координата X начала >= 0; e — способ раскрытия табуляции. Если значение равно null, табуляция будет заменена пробелом.; startOffset — начальное смещение текста в документе >= 0
Возвращает:: ширину текста
Начиная с:: 9

getTabbedTextOffset

@Deprecated(since="9") public static final int getTabbedTextOffset(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset)

Устарел.

заменен на getTabbedTextOffset(Segment, FontMetrics, float, float, TabExpander, int, boolean)

Определяет относительное смещение в указанном тексте, которое наилучшим образом соответствует заданной области в системе координат представления. Реализация использует систему координат в стиле версии 1.1 с целочисленными значениями и разрешением 72 точки на дюйм.

Параметры:: s — источник текста; metrics — метрики шрифта, используемые для вычисления; x0 — начальное местоположение представления, соответствующее началу указанного текста >= 0.; x — целевое местоположение представления, которое нужно преобразовать в смещение в тексте >= 0.; e — способ раскрытия табуляции. Если значение равно null, табуляция будет заменена пробелом.; startOffset — начальное смещение текста в документе >= 0
Возвращает:: смещение в тексте >= 0

getTabbedTextOffset

@Deprecated(since="9") public static final int getTabbedTextOffset(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset, boolean round)

Устарел.

заменен на getTabbedTextOffset(Segment, FontMetrics, float, float, TabExpander, int, boolean)

Определяет относительное смещение в указанном тексте, которое наилучшим образом соответствует заданной области в системе координат представления.

Параметры:: s — источник текста; metrics — метрики шрифта, используемые для вычисления; x0 — начальное местоположение представления, соответствующее началу указанного текста >= 0.; x — целевое местоположение представления, которое нужно преобразовать в смещение в тексте >= 0.; e — способ раскрытия табуляции. Если значение равно null, табуляция будет заменена пробелом.; startOffset — начальное смещение текста в документе >= 0; round — следует ли округлять
Возвращает:: смещение в тексте >= 0

getTabbedTextOffset

public static final int getTabbedTextOffset(Segment s, FontMetrics metrics, float x0, float x, TabExpander e, int startOffset, boolean round)

Параметры:: s — источник текста; metrics — метрики шрифта, используемые для вычисления; x0 — начальное местоположение представления, соответствующее началу указанного текста >= 0.; x — целевое местоположение представления, которое нужно преобразовать в смещение в тексте >= 0.; e — способ раскрытия табуляции. Если значение равно null, табуляция будет заменена пробелом.; startOffset — начальное смещение текста в документе >= 0; round — следует ли округлять
Возвращает:: смещение в тексте >= 0
Начиная с:: 9

getBreakLocation

@Deprecated(since="9") public static final int getBreakLocation(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset)

Устарел.

заменен на getBreakLocation(Segment, FontMetrics, float, float, TabExpander, int)

Определяет место разрыва указанного текста, чтобы он поместился в заданную область. Метод пытается найти границу слова.

Параметры:: s — источник текста; metrics — метрики шрифта, используемые для вычисления; x0 — начальное местоположение представления, соответствующее началу указанного текста.; x — целевое местоположение представления, которое нужно преобразовать в смещение в тексте.; e — способ раскрытия табуляции. Если значение равно null, табуляция будет заменена пробелом.; startOffset — начальное смещение текста в документе
Возвращает:: смещение в указанном тексте

getBreakLocation

public static final int getBreakLocation(Segment s, FontMetrics metrics, float x0, float x, TabExpander e, int startOffset)

Параметры:: s — источник текста; metrics — метрики шрифта, используемые для вычисления; x0 — начальное местоположение представления, соответствующее началу указанного текста.; x — целевое местоположение представления, которое нужно преобразовать в смещение в тексте.; e — способ раскрытия табуляции. Если значение равно null, табуляция будет заменена пробелом.; startOffset — начальное смещение текста в документе
Возвращает:: смещение в указанном тексте
Начиная с:: 9

getRowStart

public static final int getRowStart(JTextComponent c, int offs) throws BadLocationException

Определяет начальную позицию модели строки, содержащей указанную позицию модели. Для вычисления результата компонент должен иметь размер. Если размер компонента не задан, возвращается значение -1.

Параметры:: c — редактор; offs — смещение в документе >= 0
Возвращает:: позицию >= 0, если запрос можно вычислить; в противном случае возвращается значение -1.
Выбрасывает:: BadLocationException — если смещение выходит за допустимые пределы

getRowEnd

public static final int getRowEnd(JTextComponent c, int offs) throws BadLocationException

Определяет конечную позицию модели строки, содержащей указанную позицию модели. Для вычисления результата компонент должен иметь размер. Если размер компонента не задан, возвращается значение -1.

Параметры:: c — редактор; offs — смещение в документе >= 0
Возвращает:: позицию >= 0, если запрос можно вычислить; в противном случае возвращается значение -1.
Выбрасывает:: BadLocationException — если смещение выходит за допустимые пределы

getPositionAbove

@Deprecated(since="9") public static final int getPositionAbove(JTextComponent c, int offs, int x) throws BadLocationException

Устарел.

заменен на getPositionAbove(JTextComponent, int, float)

Определяет позицию в модели, ближайшую к указанному местоположению представления в строке выше. Для вычисления результата компонент должен иметь размер. Если размер компонента не задан, возвращается значение -1.

Параметры:: c — редактор; offs — смещение в документе >= 0; x — координата X >= 0
Возвращает:: позицию >= 0, если запрос можно вычислить; в противном случае возвращается значение -1.
Выбрасывает:: BadLocationException — если смещение выходит за допустимые пределы

getPositionAbove

public static final int getPositionAbove(JTextComponent c, int offs, float x) throws BadLocationException

Параметры:: c — редактор; offs — смещение в документе >= 0; x — координата X >= 0
Возвращает:: позицию >= 0, если запрос можно вычислить; в противном случае возвращается значение -1.
Выбрасывает:: BadLocationException — если смещение выходит за допустимые пределы
Начиная с:: 9

getPositionBelow

@Deprecated(since="9") public static final int getPositionBelow(JTextComponent c, int offs, int x) throws BadLocationException

Устарел.

заменен на getPositionBelow(JTextComponent, int, float)

Определяет позицию в модели, ближайшую к указанному местоположению представления в строке ниже. Для вычисления результата компонент должен иметь размер. Если размер компонента не задан, возвращается значение -1.

Параметры:: c — редактор; offs — смещение в документе >= 0; x — координата X >= 0
Возвращает:: позицию >= 0, если запрос можно вычислить; в противном случае возвращается значение -1.
Выбрасывает:: BadLocationException — если смещение выходит за допустимые пределы

getPositionBelow

public static final int getPositionBelow(JTextComponent c, int offs, float x) throws BadLocationException

Параметры:: c — редактор; offs — смещение в документе >= 0; x — координата X >= 0
Возвращает:: позицию >= 0, если запрос можно вычислить; в противном случае возвращается значение -1.
Выбрасывает:: BadLocationException — если смещение выходит за допустимые пределы
Начиная с:: 9

getWordStart

public static final int getWordStart(JTextComponent c, int offs) throws BadLocationException

Определяет начало слова для указанного местоположения в модели. Для определения слов используется BreakIterator.getWordInstance().

Параметры:: c — редактор; offs — смещение в документе >= 0
Возвращает:: местоположение начала слова в модели >= 0
Выбрасывает:: BadLocationException — если смещение выходит за допустимые пределы

getWordEnd

public static final int getWordEnd(JTextComponent c, int offs) throws BadLocationException

Определяет конец слова для указанного местоположения. Для определения слов используется BreakIterator.getWordInstance().

Параметры:: c — редактор; offs — смещение в документе >= 0
Возвращает:: местоположение конца слова в модели >= 0
Выбрасывает:: BadLocationException — если смещение выходит за допустимые пределы

getNextWord

public static final int getNextWord(JTextComponent c, int offs) throws BadLocationException

Определяет начало следующего слова для указанного местоположения. Для определения слов используется BreakIterator.getWordInstance().

Параметры:: c — редактор; offs — смещение в документе >= 0
Возвращает:: местоположение начала слова в модели >= 0
Выбрасывает:: BadLocationException — если смещение выходит за допустимые пределы

getPreviousWord

public static final int getPreviousWord(JTextComponent c, int offs) throws BadLocationException

Определяет начало предыдущего слова для указанного местоположения. Для определения слов используется BreakIterator.getWordInstance().

Параметры:: c — редактор; offs — смещение в документе >= 0
Возвращает:: местоположение начала слова в модели >= 0
Выбрасывает:: BadLocationException — если смещение выходит за допустимые пределы

getParagraphElement

public static final Element getParagraphElement(JTextComponent c, int offs)

Определяет элемент, используемый для абзаца/строки.

Параметры:: c — редактор; offs — начальное смещение в документе >= 0
Возвращает:: элемент

© 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.