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

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

Утилиты

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.

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

Deprecated.

заменено на 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

Deprecated.

заменено на 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, 2021, 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/17/docs/api/java.desktop/javax/swing/text/Utilities.html