モジュール java.desktop

パッケージ javax.swing.text

クラスPlainView

java.lang.Object

javax.swing.text.View

javax.swing.text.PlainView

すべての実装されたインタフェース:

SwingConstants, TabExpander

直系の既知のサブクラス:

FieldView

public class PlainView extends View implements TabExpander

フォントと色が1種類ずつのテキストを含む単純な複数行テキスト・ビューのために、Viewインタフェースを実装します。 ビューは、子要素をそれぞれ1行のテキストで表します。

関連項目:

• View

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected FontMetrics	metrics	現在のフォントのフォント・メトリックスです。

クラスjavax.swing.text.Viewで宣言されたフィールド

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

インタフェースjavax.swing.SwingConstantsで宣言されているフィールド

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
PlainView(Element elem)	要素でラップされた新しいPlainViewを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)	このビューが扱う位置で属性が変更されたことをドキュメントから通知します。
protected void	damageLineRange(int line0, int line1, Shape a, Component host)	指定された行範囲を再ペイントします。
protected void	drawLine(int lineIndex, Graphics2D g, float x, float y)	末尾の余白を抑止し、タブを拡張しながら、1行のテキストをレンダリングします。
protected void	drawLine(int lineIndex, Graphics g, int x, int y)	非推奨。 drawLine(int, Graphics2D, float, float)に置き換えられました
protected float	drawSelectedText(Graphics2D g, float x, float y, int p0, int p1)	モデル内の指定された範囲を、選択されたテキストとしてレンダリングします。
protected int	drawSelectedText(Graphics g, int x, int y, int p0, int p1)	非推奨。 drawSelectedText(Graphics2D, float, float, int, int)に置き換えられました
protected float	drawUnselectedText(Graphics2D g, float x, float y, int p0, int p1)	モデル内の指定された範囲を通常の選択されていないテキストとしてレンダリングします。
protected int	drawUnselectedText(Graphics g, int x, int y, int p0, int p1)	非推奨。 drawUnselectedText(Graphics2D, float, float, int, int)に置き換えられました
protected final Segment	getLineBuffer()	関連するドキュメントからテキストを取得するために使用できるバッファへのアクセスを提供します。
float	getPreferredSpan(int axis)	このビューに適切なスパンを軸に沿って指定します。
protected int	getTabSize()	ドキュメントに設定されたタブのサイズを返します。デフォルトは8です。
void	insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)	このビューが扱う位置でドキュメントに何かが挿入されたことを通知します。
protected Rectangle	lineToRect(Shape a, int line)	指定した行を表す矩形を判別します。
Shape	modelToView(int pos, Shape a, Position.Bias b)	ドキュメント・モデルの座標空間からビューの座標空間へのマッピングを提供します。
float	nextTabStop(float x, int tabOffset)	指定された参照位置より後ろの次のタブストップ位置を返します。
void	paint(Graphics g, Shape a)	指定されたレンダリング表面およびその表面上の領域を使ってレンダリングします。
void	removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)	このビューが扱うドキュメント内の位置から何かが削除されたということを通知します。
void	setSize(float width, float height)	ビューのサイズを設定します。
protected void	updateDamage(DocumentEvent changes, Shape a, ViewFactory f)	指定されたドキュメント・イベントでカバーされる変更領域を再ペイントします。
protected void	updateMetrics()	フォント・メトリックスと最長の線が最新であるかどうかを確認します。
int	viewToModel(float x, float y, Shape a, Position.Bias[] bias)	ビューの座標空間からモデルの論理座標空間へのマッピングを提供します。

クラスjavax.swing.text.Viewで宣言されたメソッド

append, breakView, createFragment, forwardUpdate, forwardUpdateToView, getAlignment, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, replace, setParent, updateChildren, updateLayout, viewToModel

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールド詳細

metrics

protected FontMetrics metrics

現在のフォントのフォント・メトリックスです。

コンストラクタの詳細

PlainView

public PlainView(Element elem)

要素でラップされた新しいPlainViewを構築します。

パラメータ:

elem - 要素

メソッドの詳細

getTabSize

protected int getTabSize()

ドキュメントに設定されたタブのサイズを返します。デフォルトは8です。

戻り値:

タブのサイズ

drawLine

@Deprecated(since="9") protected void drawLine(int lineIndex, Graphics g, int x, int y)

非推奨。

drawLine(int, Graphics2D, float, float)に置き換えられました

末尾の余白を抑止し、タブを拡張しながら、1行のテキストをレンダリングします。 このメソッドは、選択されたテキストまたは選択されていないテキストが描画される方法をカスタマイズできるように、drawUnselectedTextおよびdrawSelectedTextメソッドを呼び出すために実装されます。

パラメータ:

lineIndex - 描画する行>= 0

g - Graphicsコンテキスト

x - 開始X位置>= 0

y - 開始Y位置>= 0

関連項目:

• drawUnselectedText(java.awt.Graphics, int, int, int, int)
• drawSelectedText(java.awt.Graphics, int, int, int, int)

drawLine

protected void drawLine(int lineIndex, Graphics2D g, float x, float y)

末尾の余白を抑止し、タブを拡張しながら、1行のテキストをレンダリングします。 このメソッドは、選択されたテキストまたは選択されていないテキストが描画される方法をカスタマイズできるように、drawUnselectedTextおよびdrawSelectedTextメソッドを呼び出すために実装されます。

パラメータ:

lineIndex - >= 0を描く線

g - Graphicsコンテキスト

x - 開始X位置>= 0

y - 開始Y位置>= 0

導入されたバージョン:

9

関連項目:

• drawUnselectedText(java.awt.Graphics, int, int, int, int)
• drawSelectedText(java.awt.Graphics, int, int, int, int)

drawUnselectedText

@Deprecated(since="9") protected int drawUnselectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException

非推奨。

drawUnselectedText(Graphics2D, float, float, int, int)に置き換えられました

モデル内の指定された範囲を通常の選択されていないテキストとしてレンダリングします。 フォアグラウンド・カラーまたは使用不可の色を使ってテキストを描画します。

パラメータ:

g - グラフィックス・コンテキスト

x - 開始X座標>= 0

y - 開始Y座標>= 0

p0 - モデル内の開始位置>= 0

p1 - モデル内の終了位置>= 0

戻り値:

範囲の終了のX位置>= 0

例外:

BadLocationException - 範囲が無効な場合

drawUnselectedText

protected float drawUnselectedText(Graphics2D g, float x, float y, int p0, int p1) throws BadLocationException

モデル内の指定された範囲を通常の選択されていないテキストとしてレンダリングします。 フォアグラウンド・カラーまたは使用不可の色を使ってテキストを描画します。

パラメータ:

g - グラフィックス・コンテキスト

x - 開始X座標>= 0

y - 開始Y座標>= 0

p0 - >= 0モデルの開始位置

p1 - モデル>= 0の終了位置

戻り値:

範囲>= 0の終わりのXロケーション

例外:

BadLocationException - 範囲が無効な場合

導入されたバージョン:

9

drawSelectedText

@Deprecated(since="9") protected int drawSelectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException

非推奨。

drawSelectedText(Graphics2D, float, float, int, int)に置き換えられました

モデル内の指定された範囲を、選択されたテキストとしてレンダリングします。 このメソッドは、収容側コンポーネントで指定された色でテキストを描画するために実装されます。 このメソッドは、ハイライタが選択されたバックグラウンドを描画することを前提にしています。

パラメータ:

g - グラフィックス・コンテキスト

x - 開始X座標>= 0

y - 開始Y座標>= 0

p0 - モデル内の開始位置>= 0

p1 - モデル内の終了位置>= 0

戻り値:

範囲の終了の位置

例外:

BadLocationException - 範囲が無効な場合

drawSelectedText

protected float drawSelectedText(Graphics2D g, float x, float y, int p0, int p1) throws BadLocationException

モデル内の指定された範囲を、選択されたテキストとしてレンダリングします。 このメソッドは、収容側コンポーネントで指定された色でテキストを描画するために実装されます。 このメソッドは、ハイライタが選択されたバックグラウンドを描画することを前提にしています。

パラメータ:

g - グラフィックス・コンテキスト

x - 開始X座標>= 0

y - 開始Y座標>= 0

p0 - >= 0モデルの開始位置

p1 - モデル>= 0の終了位置

戻り値:

範囲の終了の位置

例外:

BadLocationException - 範囲が無効な場合

導入されたバージョン:

9

getLineBuffer

protected final Segment getLineBuffer()

関連するドキュメントからテキストを取得するために使用できるバッファへのアクセスを提供します。

戻り値:

バッファ

updateMetrics

protected void updateMetrics()

フォント・メトリックスと最長の線が最新であるかどうかを確認します。

導入されたバージョン:

1.4

getPreferredSpan

public float getPreferredSpan(int axis)

このビューに適切なスパンを軸に沿って指定します。

定義:

getPreferredSpan、クラスView

パラメータ:

axis - View.X_AXISまたはView.Y_AXIS

戻り値:

ビューの描画先のスパン>= 0。 通常、ビューは返されたスパン内に描画されるよう求められるが、その保証はない。 親はビューのサイズの変更や分割を行う可能性がある。

例外:

IllegalArgumentException - 軸が無効な場合

paint

public void paint(Graphics g, Shape a)

指定されたレンダリング表面およびその表面上の領域を使ってレンダリングします。 ビューは、指定された割当てにそれ自体を描画するために、レイアウトを行なったり、子ビューを作成したりする必要がある場合があります。

定義:

paint、クラスView

パラメータ:

g - 使用する描画表面

a - 描画するために割り当てられた領域

関連項目:

• View.paint(java.awt.Graphics, java.awt.Shape)

modelToView

public Shape modelToView(int pos, Shape a, Position.Bias b) throws BadLocationException

ドキュメント・モデルの座標空間からビューの座標空間へのマッピングを提供します。

定義:

modelToView、クラスView

パラメータ:

pos - 変換対象の位置>= 0

a - 描画するために割り当てられた領域

b - 位置が2つのビューの境界である場合に、オフセットによって表される直前の文字または次の文字へのバイアス。bの値は次のどれかになる。

• Position.Bias.Forward
• Position.Bias.Backward

戻り値:

指定された位置のバウンディング・ボックス

例外:

BadLocationException - 指定された位置が、関連するドキュメント内の有効な位置を示さない場合

関連項目:

• View.modelToView(int, java.awt.Shape, javax.swing.text.Position.Bias)

viewToModel

public int viewToModel(float x, float y, Shape a, Position.Bias[] bias)

ビューの座標空間からモデルの論理座標空間へのマッピングを提供します。

定義:

viewToModel、クラスView

パラメータ:

x - X座標>= 0

y - Y座標>= 0

a - 描画するために割り当てられた領域

bias - 戻りバイアス

戻り値:

指定されたビュー内の点をもっとも適切に表現するモデル内の位置>= 0

関連項目:

• View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

insertUpdate

public void insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)

このビューが扱う位置でドキュメントに何かが挿入されたことを通知します。

オーバーライド:

insertUpdate、クラスView

パラメータ:

changes - 関連するドキュメントからの変更情報

a - ビューの現在の割当て

f - ビューが子を持つ場合に再構築に使用するファクトリ

関連項目:

• View.insertUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

removeUpdate

public void removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)

このビューが扱うドキュメント内の位置から何かが削除されたということを通知します。

オーバーライド:

removeUpdate、クラスView

パラメータ:

changes - 関連するドキュメントからの変更情報

a - ビューの現在の割当て

f - ビューが子を持つ場合に再構築に使用するファクトリ

関連項目:

• View.removeUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

changedUpdate

public void changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)

このビューが扱う位置で属性が変更されたことをドキュメントから通知します。

オーバーライド:

changedUpdate、クラスView

パラメータ:

changes - 関連するドキュメントからの変更情報

a - ビューの現在の割当て

f - ビューが子を持つ場合に再構築に使用するファクトリ

関連項目:

• View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

setSize

public void setSize(float width, float height)

ビューのサイズを設定します。 レイアウトの必要がある場合は、指定した軸に沿ったビューのレイアウトを表示します。

オーバーライド:

setSize、クラスView

パラメータ:

width - 幅>= 0

height - 高さ>= 0

nextTabStop

public float nextTabStop(float x, int tabOffset)

指定された参照位置より後ろの次のタブストップ位置を返します。 この実装は中央揃えなどの機能をサポートしていないので、tabOffset引数を無視します。

定義:

nextTabStop、インタフェースTabExpander

パラメータ:

x - 現在位置>= 0

tabOffset - タブが発生するテキスト・ストリーム内の位置>= 0。

戻り値:

ポイント単位で測定されたタブストップ>= 0

updateDamage

protected void updateDamage(DocumentEvent changes, Shape a, ViewFactory f)

指定されたドキュメント・イベントでカバーされる変更領域を再ペイントします。 挿入または削除が単一の行に対してのみ実行される場合をカバーするため、範囲の開始行を損傷します。 複数の行を追加または削除した場合は、ビュー全体を損傷します。 最長の行が変更されていないかどうかチェックされます。

パラメータ:

changes - 関連するドキュメントからの変更情報

a - ビューの現在の割当て

f - ビューが子を持つ場合に再構築に使用するファクトリ

導入されたバージョン:

1.4

damageLineRange

protected void damageLineRange(int line0, int line1, Shape a, Component host)

指定された行範囲を再ペイントします。

パラメータ:

line0 - 再描画の開始行番号。 モデル内の有効な行番号である必要がある。

line1 - 再描画の終了行番号。 モデル内の有効な行番号である必要がある。

a - 描画のためにビューに割り当てられた領域

host - ビューを収容するコンポーネント(再描画の呼出しに使用)

導入されたバージョン:

1.4

lineToRect

protected Rectangle lineToRect(Shape a, int line)

指定した行を表す矩形を判別します。

パラメータ:

a - 描画のためにビューに割り当てられた領域

line - 範囲の検索に使用する行番号。 モデル内の有効な行番号である必要がある。

戻り値:

指定された行を表す矩形

導入されたバージョン:

1.4