Module java.desktop
Package javax.swing.text

Class Utilities

java.lang.Object
javax.swing.text.Utilities
public class Utilities extends Object
一组处理各种文本相关活动的方法。

  • Constructor Details

    • Utilities

      public Utilities()
      构造一个Utilities。

  • Method Details

    • drawTabbedText

      @Deprecated(since="9") public static final int drawTabbedText(Segment s, int x, int y, Graphics g, TabExpander e, int startOffset)
      Deprecated.
      replaced by drawTabbedText(Segment, float, float, Graphics2D, TabExpander, int)
      绘制给定的文本，使用给定的制表符扩展技术展开任何包含的制表符。这个特定的实现在1.1样式坐标系中呈现，其中使用整数，假定为72dpi。
      参数：
      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)
      Deprecated.
      replaced by getTabbedTextWidth(Segment, FontMetrics, float, TabExpander, int)
      确定考虑制表符的给定文本段的宽度。这是在1.1样式坐标系中实现的，其中使用整数，假定为72dpi。
      参数：
      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)
      Deprecated.
      replaced by getTabbedTextOffset(Segment, FontMetrics, float, float, TabExpander, int, boolean)
      确定给定文本中相对于视图坐标系中给定跨度最佳表示的相对偏移量。这是在1.1样式坐标系中实现的，其中使用整数，假定为72dpi。
      参数：
      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)
      Deprecated.
      replaced by 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)
      Deprecated.
      replaced by 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
      Deprecated.
      replaced by 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
      Deprecated.
      replaced by 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
      返回值:
      元素