Класс 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)`	Определяет начало слова для заданной позиции в модели.

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

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

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

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

Параметры:: 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 dpi.

Параметры:: 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 dpi.

Параметры:: 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.

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

getRowEnd

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

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

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

getPositionAbove

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

Устарело.

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

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

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

getPositionAbove

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

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

getPositionBelow

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

Устарело.

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

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

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

getPositionBelow

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

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

getWordStart

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

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

Parameters:: c - редактор; offs - смещение в документе >= 0
Returns:: позиция в модели начала слова >= 0
Throws:: BadLocationException - если смещение находится вне диапазона

getWordEnd

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

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

Parameters:: c - редактор; offs - смещение в документе >= 0
Returns:: позиция в модели конца слова >= 0
Throws:: BadLocationException - если смещение находится вне диапазона

getNextWord

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

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

Parameters:: c - редактор; offs - смещение в документе >= 0
Returns:: позиция в модели начала слова >= 0
Throws:: BadLocationException - если смещение находится вне диапазона

getPreviousWord

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

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

Parameters:: c - редактор; offs - смещение в документе >= 0
Returns:: позиция в модели начала слова >= 0
Throws:: BadLocationException - если смещение находится вне диапазона

getParagraphElement

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

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

Parameters:: c - редактор; offs - начальное смещение в документе >= 0
Returns:: элемент

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/text/Utilities.html