Module  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)
        已过时。 替换为drawTabbedText(Segment, float, float, Graphics2D, TabExpander, int)
        绘制给定的文本，使用给定的选项卡扩展技术扩展包含的所有选项卡。 这个特定的实现呈现在1.1样式的坐标系统中，其中使用int并且假定为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)
        已过时。 替换为getTabbedTextWidth(Segment, FontMetrics, float, TabExpander, int)
        确定考虑到选项卡的给定段文本的宽度。 这是在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)
        已过时。 替换为getTabbedTextOffset(Segment, FontMetrics, float, float, TabExpander, int, boolean)
        确定最佳表示视图坐标系中给定跨度的给定文本的相对偏移量。 这是在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)
        已过时。 由getTabbedTextOffset(Segment, FontMetrics, float, float, TabExpander, int, boolean)取代
        确定最佳表示视图坐标系中给定跨度的给定文本的相对偏移量。
        参数
        s - 文本的来源
        metrics - 用于计算的字体指标
        x0 - 表示给定文本开始的起始视图位置> = 0。
        x - 将目标视图位置转换为文本偏移=> 0。
        e - 如何扩展选项卡。 如果此值为null，则选项卡将作为空格字符扩展。
        startOffset - 文档的起始偏移量> = 0
        round - 是否 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的起始视图位置 >= 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
        结果
        如果可以计算请求，则position = 0，否则返回值-1。
        异常
        BadLocationException - 如果偏移超出范围

      • getRowEnd

        public static final int getRowEnd​(JTextComponent c,
                                  int offs)
                           throws BadLocationException
        确定包含指定模型位置的行的结束行模型位置。 给定的组件必须具有计算结果的大小。 如果组件没有大小，则返回-1值。
        参数
        c - 编辑
        offs - 文档中的偏移量> = 0
        结果
        如果可以计算请求，则position = 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
        结果
        如果可以计算请求，则position = 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
        结果
        如果可以计算请求，则position = 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
        结果
        元素