Spec-Zone.ru › OpenJDK 25

Класс 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

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

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.
Параметры:
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
Возвращает:
элемент

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, способы обхода проблем и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API