モジュール java.desktop

パッケージ javax.swing.text

クラスWrappedPlainView

java.lang.Object

javax.swing.text.View

javax.swing.text.CompositeView

javax.swing.text.BoxView

javax.swing.text.WrappedPlainView

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

SwingConstants, TabExpander

public class WrappedPlainView extends BoxView implements TabExpander

折返しを行うプレーン・テキスト(フォントおよび色が1種類ずつのテキスト)のビューです。 このビューには、関連する要素に、ラップしなければならない行を表す子要素があるはずです。 これは、論理行ビューを含む垂直ボックスとして実装されます。 論理行ビューは、論理行が割当てに収まらない場合に論理行を複数の物理行として描画するネストされたクラスです。 行ビューは、その状態の外部クラスで描画し、必要なメモリー量を削減します。

行ビューはすべての描画をdrawLineメソッドを介して行います。このメソッドは、すべての描画をdrawSelectedTextおよびdrawUnselectedTextメソッドを介して行います。 これは、サブクラスがレイアウトを考慮することなく描画を容易に特殊化できるようにします。

関連項目:

• View

フィールドのサマリー

クラス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

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

コンストラクタ

コンストラクタ	説明
WrappedPlainView(Element elem)	新しいWrappedPlainViewを作成します。
WrappedPlainView(Element elem, boolean wordWrap)	新しいWrappedPlainViewを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
protected int	calculateBreakPosition(int p0, int p1)	このメソッドは、入れ子のラップされた行ビューによって分割位置を指定するために呼び出されます。
void	changedUpdate(DocumentEvent e, Shape a, ViewFactory f)	このビューが扱う位置で属性が変更されたことをドキュメントから通知します。
protected void	drawLine(int p0, int p1, Graphics2D g, float x, float y)	末尾の余白を抑止し、タブを拡張しながら、1行のテキストをレンダリングします。
protected void	drawLine(int p0, int p1, Graphics g, int x, int y)	非推奨。 drawLine(int, 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	getMaximumSpan(int axis)	このビューの最大スパンを軸に沿って指定します。
float	getMinimumSpan(int axis)	このビューの最小スパンを軸に沿って指定します。
float	getPreferredSpan(int axis)	このビューに適切なスパンを軸に沿って指定します。
protected int	getTabSize()	ドキュメントに設定されたタブのサイズを返します。デフォルトは8です。
void	insertUpdate(DocumentEvent e, Shape a, ViewFactory f)	このビューが扱う位置でドキュメントに何かが挿入されたことを通知します。
protected void	loadChildren(ViewFactory f)	ビューを初期化するためにすべての子をロードします。
float	nextTabStop(float x, int tabOffset)	指定された参照位置より後ろの次のタブストップ位置を返します。
void	paint(Graphics g, Shape a)	指定されたレンダリング表面およびその表面上の領域を使ってレンダリングします。
void	removeUpdate(DocumentEvent e, Shape a, ViewFactory f)	このビューが扱うドキュメント内の位置から何かが削除されたということを通知します。
void	setSize(float width, float height)	ビューのサイズを設定します。

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

baselineLayout, baselineRequirements, calculateMajorAxisRequirements, calculateMinorAxisRequirements, childAllocation, flipEastAndWestAtEnds, forwardUpdate, getAlignment, getAxis, getChildAllocation, getHeight, getOffset, getResizeWeight, getSpan, getViewAtPoint, getWidth, isAfter, isAllocationValid, isBefore, isLayoutValid, layout, layoutChanged, layoutMajorAxis, layoutMinorAxis, modelToView, paintChild, preferenceChanged, replace, setAxis, viewToModel

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

getBottomInset, getInsideAllocation, getLeftInset, getNextEastWestVisualPositionFrom, getNextNorthSouthVisualPositionFrom, getNextVisualPositionFrom, getRightInset, getTopInset, getView, getViewAtPosition, getViewCount, getViewIndex, getViewIndexAtPosition, modelToView, setInsets, setParagraphInsets, setParent

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

append, breakView, createFragment, forwardUpdateToView, getAttributes, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getParent, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, isVisible, modelToView, remove, removeAll, updateChildren, updateLayout, viewToModel

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

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

コンストラクタの詳細

WrappedPlainView

public WrappedPlainView(Element elem)

新しいWrappedPlainViewを作成します。 行は、文字境界でラップされます。

パラメータ:

elem - ビューの元になる要素

WrappedPlainView

public WrappedPlainView(Element elem, boolean wordWrap)

新しいWrappedPlainViewを作成します。 行は、wordWrapパラメータの設定に応じて文字境界またはワード境界でラップできます。

パラメータ:

elem - ビューの元になる要素

wordWrap - 行がワード境界でラップされるかどうか

メソッドの詳細

getTabSize

protected int getTabSize()

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

戻り値:

タブのサイズ

drawLine

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

非推奨。

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

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

パラメータ:

p0 - 使用する開始ドキュメントの位置>= 0

p1 - 使用する終了ドキュメントの位置>= p1

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

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 p0, int p1, Graphics2D g, float x, float y)

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

パラメータ:

p0 - 使用する開始ドキュメントの位置>= 0

p1 - 使用する終了ドキュメントの位置>= p1

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

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 - モデル内の終了位置>= p0

戻り値:

範囲の終了の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 - モデル内の終了位置>= p0

戻り値:

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

例外:

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 - モデル内の終了位置>= p0

戻り値:

範囲の終了の位置。

例外:

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 - モデル内の終了位置>= p0

戻り値:

範囲の終了の位置。

例外:

BadLocationException - 範囲が無効な場合

導入されたバージョン:

9

getLineBuffer

protected final Segment getLineBuffer()

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

戻り値:

バッファ

calculateBreakPosition

protected int calculateBreakPosition(int p0, int p1)

このメソッドは、入れ子のラップされた行ビューによって分割位置を指定するために呼び出されます。 このメソッドは、分割動作を変更するために再実装できます。 このメソッドは、作成時に指定された分割引数に応じてワード境界または文字境界で分割します。

パラメータ:

p0 - 開始ドキュメントのロケーション

p1 - 終了するドキュメントの使用ロケーション

戻り値:

中断位置

loadChildren

protected void loadChildren(ViewFactory f)

ビューを初期化するためにすべての子をロードします。 これは、setParentメソッドによって呼び出されます。 サブクラスは、このメソッドを再実装して別の方法で子ビューを初期化できます。 デフォルトの実装は、子要素ごとに子ビューを作成します。

オーバーライド:

loadChildren、クラスCompositeView

パラメータ:

f - ビュー・ファクトリ

関連項目:

• CompositeView.setParent(javax.swing.text.View)

nextTabStop

public float nextTabStop(float x, int tabOffset)

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

定義:

nextTabStop、インタフェースTabExpander

パラメータ:

x - 現在位置>= 0

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

戻り値:

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

paint

public void paint(Graphics g, Shape a)

指定されたレンダリング表面およびその表面上の領域を使ってレンダリングします。 このメソッドは、入れ子の行が使用する選択位置、選択色、およびフォント・メトリックスを隠すために実装されます。

オーバーライド:

paint、クラスBoxView

パラメータ:

g - 使用する描画表面

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

関連項目:

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

setSize

public void setSize(float width, float height)

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

オーバーライド:

setSize、クラスBoxView

パラメータ:

width - 幅>= 0

height - 高さ>= 0

getPreferredSpan

public float getPreferredSpan(int axis)

このビューに適切なスパンを軸に沿って指定します。 このメソッドは、最初に現在のフォント・メトリックスがキャッシュに格納されていることを確認した後で、スーパー・クラスの動作を提供するために実装されています。これは、入れ子の行が、ラップされている行の高さを判定する場合に、このメトリックスを使用するためです。

オーバーライド:

getPreferredSpan、クラスBoxView

パラメータ:

axis - View.X_AXISまたはView.Y_AXIS

戻り値:

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

関連項目:

• View.getPreferredSpan(int)

getMinimumSpan

public float getMinimumSpan(int axis)

このビューの最小スパンを軸に沿って指定します。 このメソッドは、最初に現在のフォント・メトリックスがキャッシュに格納されていることを確認した後で、スーパー・クラスの動作を提供するために実装されています。これは、入れ子の行が、ラップされている行の高さを判定する場合に、このメトリックスを使用するためです。

オーバーライド:

getMinimumSpan、クラスBoxView

パラメータ:

axis - View.X_AXISまたはView.Y_AXIS

戻り値:

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

関連項目:

• View.getMinimumSpan(int)

getMaximumSpan

public float getMaximumSpan(int axis)

このビューの最大スパンを軸に沿って指定します。 このメソッドは、最初に現在のフォント・メトリックスがキャッシュに格納されていることを確認した後で、スーパー・クラスの動作を提供するために実装されています。これは、入れ子の行が、ラップされている行の高さを判定する場合に、このメトリックスを使用するためです。

オーバーライド:

getMaximumSpan、クラスBoxView

パラメータ:

axis - View.X_AXISまたはView.Y_AXIS

戻り値:

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

関連項目:

• View.getMaximumSpan(int)

insertUpdate

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

このビューが扱う位置でドキュメントに何かが挿入されたことを通知します。 このメソッドは、単純に子を更新するために実装されます。

オーバーライド:

insertUpdate、クラスView

パラメータ:

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

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

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

関連項目:

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

removeUpdate

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

このビューが扱うドキュメント内の位置から何かが削除されたということを通知します。 このメソッドは、単純に子を更新するために実装されます。

オーバーライド:

removeUpdate、クラスView

パラメータ:

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

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

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

関連項目:

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

changedUpdate

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

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

オーバーライド:

changedUpdate、クラスView

パラメータ:

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

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

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

関連項目:

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