JavaTM 2 Platform
Standard Ed. 6

javax.swing.text
類別 Utilities

java.lang.Object
  繼承者 javax.swing.text.Utilities

public class Utilities
extends Object

處理各種文本相關活動的方法集合。


建構子摘要
Utilities()
           
 
方法摘要
static int drawTabbedText(Segment s, int x, int y, Graphics g, 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, int 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, 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 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

public static final int drawTabbedText(Segment s,
                                       int x,
                                       int y,
                                       Graphics g,
                                       TabExpander e,
                                       int startOffset)
使用給定的製表符擴展方式來擴展給定文本所包含的任何製表符,從而繪製給定的文本。此特別實作在一個使用 int 和假定為 72dpi 的 1.1 樣式的坐標系統中進行呈現。

參數:
s - 文本源
x - X 起始處,該值 >= 0
y - Y 起始處,該值 >= 0
g - 圖形上下文
e - 擴展製表符的方式如果此值為 null,則製表符將被擴展成為一個空白字元。
startOffset - 文檔中文本的起始偏移量,該值 >= 0
返回:
處於呈現的文本結尾的 X 位置

getTabbedTextWidth

public static final int getTabbedTextWidth(Segment s,
                                           FontMetrics metrics,
                                           int x,
                                           TabExpander e,
                                           int startOffset)
確定給定的考慮製表符的文本段的寬度。在一個使用 int 和假定為 72dpi 的 1.1 樣式的坐標系統中實作此方法。

參數:
s - 文本源
metrics - 用於計算的字體規格
x - X 起始處,該值 >= 0
e - 擴展製表符的方式。如果此值為 null,則製表符將被擴展成為一個空白字元。
startOffset - 文檔中文本的起始偏移量,該值 >= 0
返回:
文本的寬度

getTabbedTextOffset

public static final int getTabbedTextOffset(Segment s,
                                            FontMetrics metrics,
                                            int x0,
                                            int x,
                                            TabExpander e,
                                            int startOffset)
確定給定文本中的某個相對偏移量,使其能最好的表示視圖坐標系統中的給定跨距。在一個使用 int 和假定為 72dpi 的 1.1 樣式的坐標系統中實作此方法。

參數:
s - 文本源
metrics - 用於計算的字體規格
x0 - 代表給定文本開始處起始視圖的位置,該值 >= 0。
x - 要轉換為文本中偏移量的目標視圖位置,該值 >= 0。
e - 擴展製表符的方式。如果此值為 null,則製表符將被擴展成為一個空白字元。
startOffset - 文檔中文本的起始偏移量,該值 >= 0
返回:
文本中的偏移量,該值 >= 0

getTabbedTextOffset

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

getBreakLocation

public static final int getBreakLocation(Segment s,
                                         FontMetrics metrics,
                                         int x0,
                                         int x,
                                         TabExpander e,
                                         int startOffset)
確定對給定文本進行拆分的位置,以符合給定的跨距。此方法試圖找到一個字邊界。

參數:
s - 文本源
metrics - 用於計算的字體規格
x0 - 表示給定文本開始處的起始視圖位置。
x - 要轉換為文本中偏移量的目標視圖位置。
e - 擴展製表符的方式。如果此值為 null,則製表符將被擴展成為一個空白字元。
startOffset - 文本文檔中的起始偏移量
返回:
給定文本中的偏移量

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

public static final int getPositionAbove(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,
                                         int x)
                                  throws BadLocationException
確定模型中離行下方給定的視圖位置最近的位置。該給定元件必須具有一個用來計算結果的大小。如果元件不具有大小,則將返回值 -1。

參數:
c - 編輯器
offs - 文檔中的偏移量,該值 >= 0
x - X 坐標,該值 >= 0
返回:
如果請求能被計算,則返回 >= 0 的位置;否則將返回值 -1。
拋出:
BadLocationException - 如果偏移量超出範圍

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
返回:
元素

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only