模块  java.desktop
软件包  javax.swing.text

Class Utilities


  • public class Utilities
    extends Object
    处理各种文本相关活动的方法集合。
    • 构造方法详细信息

      • 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样式坐标系中,其中使用整数并假设为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)
        确定考虑标签的给定文本段的宽度。 这是在1.1样式坐标系中实现的,其中使用了int并假设为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)
        确定给定文本中最能代表视图坐标系中给定范围的相对偏移量。 这是在1.1样式坐标系中实现的,其中使用了int并假设为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)
        确定给定文本中最能代表视图坐标系中给定范围的相对偏移量。
        参数
        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
        结果
        单词start> = 0的模型中的位置
        异常
        BadLocationException - 如果偏移量超出范围
      • getWordEnd

        public static final int getWordEnd​(JTextComponent c,
                                           int offs)
                                    throws BadLocationException
        确定给定位置的单词结尾。 使用BreakIterator.getWordInstance()来实际获取单词。
        参数
        c - 编辑
        offs - 文档中的偏移量> = 0
        结果
        单词end> = 0的模型中的位置
        异常
        BadLocationException - 如果偏移量超出范围
      • getNextWord

        public static final int getNextWord​(JTextComponent c,
                                            int offs)
                                     throws BadLocationException
        确定给定位置的下一个单词的开头。 使用BreakIterator.getWordInstance()来实际获取单词。
        参数
        c - 编辑
        offs - 文档中的偏移量> = 0
        结果
        单词start> = 0的模型中的位置
        异常
        BadLocationException - 如果偏移量超出范围
      • getPreviousWord

        public static final int getPreviousWord​(JTextComponent c,
                                                int offs)
                                         throws BadLocationException
        确定给定位置的prev字的开头。 使用BreakIterator.getWordInstance()来实际获取单词。
        参数
        c - 编辑
        offs - 文档中的偏移量> = 0
        结果
        单词start> = 0的模型中的位置
        异常
        BadLocationException - 如果偏移量超出范围
      • getParagraphElement

        public static final Element getParagraphElement​(JTextComponent c,
                                                        int offs)
        确定用于段落/行的元素。
        参数
        c - 编辑
        offs - 文档中的起始偏移量> = 0
        结果
        the element