JavaTM 2 Platform
Std. Ed. v1.3

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
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.