Класс Utilities
java.lang.Object
javax.swing.text.Utilities
public class Utilities extends Object
Набор методов для выполнения различных операций, связанных с текстом.
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
Utilities() |
Создает Utilities. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
static final float |
drawTabbedText |
Отображает заданный текст, раскрывая все содержащиеся в нем символы табуляции с помощью заданного способа раскрытия табуляции. |
static final int |
drawTabbedText |
Устарел. |
static final int |
getBreakLocation |
Определяет, где разбить заданный текст, чтобы он поместился в заданном интервале. |
static final int |
getBreakLocation |
Устарел. |
static final int |
getNextWord |
Определяет начало следующего слова для заданной позиции. |
static final Element |
getParagraphElement |
Определяет элемент, используемый для абзаца/строки. |
static final int |
getPositionAbove |
Определяет позицию в модели, ближайшую к заданному расположению в представлении в строке выше. |
static final int |
getPositionAbove |
Устарел. заменен на getPositionAbove(JTextComponent, int, float)
|
static final int |
getPositionBelow |
Определяет позицию в модели, ближайшую к заданному расположению в представлении в строке ниже. |
static final int |
getPositionBelow |
Устарел. заменен на getPositionBelow(JTextComponent, int, float)
|
static final int |
getPreviousWord |
Определяет начало предыдущего слова для заданной позиции. |
static final int |
getRowEnd |
Определяет конечную позицию строки в модели для строки, содержащей указанную позицию модели. |
static final int |
getRowStart |
Определяет начальную позицию строки в модели для строки, содержащей указанную позицию модели. |
static final int |
getTabbedTextOffset |
Определяет относительное смещение в заданном тексте, которое лучше всего соответствует заданному интервалу в системе координат представления. |
static final int |
getTabbedTextOffset |
|
static final int |
getTabbedTextOffset |
|
static final float |
getTabbedTextWidth |
Определяет ширину заданного фрагмента текста с учетом символов табуляции. |
static final int |
getTabbedTextWidth |
Устарел. |
static final int |
getWordEnd |
Определяет конец слова для заданной позиции. |
static final int |
getWordStart |
Определяет начало слова для заданной позиции модели. |
Подробное описание конструкторов
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)
Устарел.
Отображает заданный текст, раскрывая все содержащиеся в нем символы табуляции с помощью заданного способа раскрытия табуляции. Эта реализация выполняет отрисовку в системе координат в стиле 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)
Устарел.
Определяет ширину заданного фрагмента текста с учетом символов табуляции. Реализация использует систему координат в стиле 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)
Устарел.
Определяет относительное смещение в заданном тексте, которое лучше всего соответствует заданному интервалу в системе координат представления. Реализация использует систему координат в стиле 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)
Устарел.
Определяет относительное смещение в заданном тексте, которое лучше всего соответствует заданному интервалу в системе координат представления.
- Параметры:
-
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)
Устарел.
Определяет, где разбить заданный текст, чтобы он поместился в заданном интервале. Метод пытается найти границу слова.
- Параметры:
-
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
Определяет позицию в модели, ближайшую к заданному расположению в представлении в строке выше. Для вычисления результата указанный компонент должен иметь заданный размер. Если размер компонента не задан, возвращается значение -1.
- Параметры:
-
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
Определяет позицию в модели, ближайшую к заданному расположению в представлении в строке ниже. Для вычисления результата указанный компонент должен иметь заданный размер. Если размер компонента не задан, возвращается значение -1.
- Параметры:
-
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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/text/Utilities.html
drawTabbedText(Segment, float, float, Graphics2D, TabExpander, int)