javax.swing.text
クラス PlainView

java.lang.Object
  |
  +--javax.swing.text.View
        |
        +--javax.swing.text.PlainView

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

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

コンストラクタの概要

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

メソッドの概要

void	changedUpdate(DocumentEvent changes, Shape a, ViewFactory f) このビューが担当する位置で属性が変更されたということをドキュメントから通知します。
protected void	drawLine(int lineIndex, Graphics g, int x, int y) 1 行のテキストを、末尾の空白を抑制しタブがあれば展開して描画します。
protected int	drawSelectedText(Graphics g, int x, int y, int p0, int p1) モデル内の指定された範囲を、選択したテキストで描画します。
protected int	drawUnselectedText(Graphics g, int x, int y, int p0, int p1) モデル内の指定された範囲を、選択解除した通常のテキストで描画します。
protected Segment	getLineBuffer() 関連付けられているドキュメントからテキストを取得するために使うことができるバッファへのアクセスを提供します。
float	getPreferredSpan(int axis) このビューの望ましいスパンを軸に沿って指定します。
protected int	getTabSize() ドキュメントに設定されたタブサイズを返します (デフォルトは 8)。
void	insertUpdate(DocumentEvent changes, Shape a, ViewFactory f) このビューが担当するドキュメント内の位置に何かが挿入されたということを通知します。
Shape	modelToView(int pos, Shape a, Position.Bias b) ドキュメントモデルの座標空間からそれに対応付けられるビューの座標空間への対応付けを提供します。
float	nextTabStop(float x, int tabOffset) 指定された参照位置より後の次のタブストップ位置を返します。
void	paint(Graphics g, Shape a) 指定された描画表面とその領域を使って描画します。
void	preferenceChanged(View child, boolean width, boolean height) 望ましいスパンが変更されたことを伝えます。
void	removeUpdate(DocumentEvent changes, Shape a, ViewFactory f) このビューが担当するドキュメント内の位置から何かが削除されたということを通知します。
int	viewToModel(float fx, float fy, Shape a, Position.Bias[] bias) ビュー座標空間からモデルの論理座標空間への対応付けを提供します。

クラス javax.swing.text.View から継承したメソッド

breakView, createFragment, getAlignment, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getView, getViewCount, getViewFactory, isVisible, modelToView, modelToView, setParent, setSize, 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

protected void drawLine(int lineIndex,
                        Graphics g,
                        int x,
                        int y)

1 行のテキストを、末尾の空白を抑制しタブがあれば展開して描画します。このメソッドを実装すると、drawUnselectedText メソッドと drawSelectedText メソッドへの呼び出しを実行できるので、選択したテキストと選択解除したテキストの描画方法をカスタマイズできます。

パラメータ:

lineIndex - 描画する行 >= 0

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

x - X の開始座標 >= 0

y - Y の開始座標 >= 0

関連項目:

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

drawUnselectedText

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

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

パラメータ:

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

x - X の開始座標 >= 0

y - Y の開始座標 >= 0

p0 - モデル内の先頭位置 >= 0

p1 - モデル内の末尾位置 >= 0

戻り値:

範囲末尾の X 座標 >= 0

例外:

BadLocationException - 範囲が無効な場合

drawSelectedText

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

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

パラメータ:

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

x - X の開始座標 >= 0

y - Y の開始座標 >= 0

p0 - モデル内の先頭位置 >= 0

p1 - モデル内の末尾位置 >= 0

戻り値:

範囲末尾の位置

例外:

BadLocationException - 範囲が無効な場合

getLineBuffer

protected final Segment getLineBuffer()

関連付けられているドキュメントからテキストを取得するために使うことができるバッファへのアクセスを提供します。

戻り値:

バッファ

getPreferredSpan

public float getPreferredSpan(int axis)

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

パラメータ:

axis - View.X_AXIS または View.Y_AXIS

戻り値:

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

例外:

IllegalArgumentException - 軸が無効な場合

オーバーライド:

クラス View 内の getPreferredSpan

paint

public void paint(Graphics g,
                  Shape a)

指定された描画表面とその領域を使って描画します。ビューは指定された割り当てにそれ自身を描画できるように、レイアウトを行い子ビューを作成する必要があります。

パラメータ:

g - 使用する描画表面

a - 描画対象の割り当て領域

オーバーライド:

クラス View 内の paint

関連項目:

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

preferenceChanged

public void preferenceChanged(View child,
                              boolean width,
                              boolean height)

望ましいスパンが変更されたことを伝えます。

パラメータ:

child - 子ビュー

width - 幅の設定が変更された場合は true

height - 高さの設定が変更された場合は true

オーバーライド:

クラス View 内の preferenceChanged

関連項目:

JComponent.revalidate()

modelToView

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

ドキュメントモデルの座標空間からそれに対応付けられるビューの座標空間への対応付けを提供します。

パラメータ:

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

a - 描画対象の割り当て領域

戻り値:

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

例外:

BadLocationException - 指定された位置が、関連付けられているドキュメント内の有効な位置を表していない場合

オーバーライド:

クラス View 内の modelToView

関連項目:

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

viewToModel

public int viewToModel(float fx,
                       float fy,
                       Shape a,
                       Position.Bias[] bias)

ビュー座標空間からモデルの論理座標空間への対応付けを提供します。

パラメータ:

fx - X 座標 >= 0

fy - Y 座標 >= 0

a - 描画対象の割り当て領域

戻り値:

ビューの指定された点を最適に表すモデル内の位置 >= 0

オーバーライド:

クラス View 内の viewToModel

関連項目:

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

insertUpdate

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

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

パラメータ:

changes - 関連付けられているドキュメントからの変更情報

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

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

オーバーライド:

クラス View 内の insertUpdate

関連項目:

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

removeUpdate

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

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

パラメータ:

changes - 関連付けられているドキュメントからの変更情報

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

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

オーバーライド:

クラス View 内の removeUpdate

関連項目:

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

changedUpdate

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

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

パラメータ:

changes - 関連付けられているドキュメントからの変更情報

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

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

オーバーライド:

クラス View 内の changedUpdate

関連項目:

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

nextTabStop

public float nextTabStop(float x,
                         int tabOffset)

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

定義:

インタフェース TabExpander 内の nextTabStop

パラメータ:

x - 現在の位置 >= 0

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

戻り値:

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