Класс Utilities

public class Utilities
extends Object

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

Конструкторы

Конструктор Описание
Utilities()

Методы

Модификатор и тип Метод Описание
static float drawTabbedText​(Segment s, float x, float y, Graphics2D g, TabExpander e, int startOffset)

Отображает заданный текст, расширяя все табуляции с использованием заданной техники расширения табуляции.
static int drawTabbedText​(Segment s, int x, int y, Graphics g, TabExpander e, int startOffset)

Устаревший.

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

Определяет, где разбить заданный текст, чтобы он поместился в заданном диапазоне.
static int getBreakLocation​(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset)

Устаревший.

static int getNextWord​(JTextComponent c, int offs)

Определяет начало следующего слова для заданной позиции.
static Element getParagraphElement​(JTextComponent c, int offs)

Определяет элемент для использования в абзаце/строке.
static int getPositionAbove​(JTextComponent c, int offs, float x)

Определяет позицию в модели, которая наиболее близка к заданной позиции представления в строке выше.
static int getPositionAbove​(JTextComponent c, int offs, int x)

Устаревший.

static int getPositionBelow​(JTextComponent c, int offs, float x)

Определяет позицию в модели, которая наиболее близка к заданной позиции представления в строке ниже.
static int getPositionBelow​(JTextComponent c, int offs, int x)

Устаревший.

static int getPreviousWord​(JTextComponent c, int offs)

Определяет начало предыдущего слова для заданной позиции.
static int getRowEnd​(JTextComponent c, int offs)

Определяет конечную позицию в модели строки, содержащей указанную позицию в модели.
static int getRowStart​(JTextComponent c, int offs)

Определяет начальную позицию в модели строки, содержащей указанную позицию в модели.
static int getTabbedTextOffset​(Segment s, FontMetrics metrics, float x0, float x, TabExpander e, int startOffset, boolean round)

Определяет относительный смещение в заданном тексте, который наилучшим образом представляет заданный диапазон в системе координат представления.
static int getTabbedTextOffset​(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset)

Устаревший.

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

Устаревший.

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

Определяет ширину заданного сегмента текста, учитывая табуляции.
static int getTabbedTextWidth​(Segment s, FontMetrics metrics, int x, TabExpander e, int startOffset)

Устаревший.

static int getWordEnd​(JTextComponent c, int offs)

Определяет конец слова для заданной позиции.
static int getWordStart​(JTextComponent c, int offs)

Определяет начало слова для заданной позиции модели.

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

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

Конструкторы

Utilities

public 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
Устаревшее.

Определяет позицию в модели, которая наиболее близка к заданной позиции представления в строке выше. У компонента должно быть задано значение размера для расчёта результата. Если у компонента нет размера, возвращается значение -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
Устарело.

Определяет позицию в модели, которая наиболее близка к заданному расположению представления в строке ниже. У заданного компонента должен быть размер для вычисления результата. Если у компонента нет размера, возвращается значение -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, 2020, 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/11/docs/api/java.desktop/javax/swing/text/Utilities.html

Spec-Zone .ru
спецификации, руководства, описания, API