JavaTM 2
Platform
Std. Ed. v1.4.0

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.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

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