javax.swing.text

クラス FlowView

java.lang.Object

javax.swing.text.View

javax.swing.text.CompositeView

javax.swing.text.BoxView

javax.swing.text.FlowView

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

SwingConstants

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

ParagraphView

public abstract class FlowView
extends BoxView

子を一部制約のある空間へ並べようとするビューです。これは、段落、ページなどを構築するときに使用できます。フローには次の機能があります。

• 配置プールとして使用して物理的ビューを作成する、子ビューの論理セット。
• 論理ビューを物理的 (フロー) ビューへ変換する方法。
• 実行にあたっての制約。
• フローを表す物理的構造。このビューの子はフロー作成のために論理ビューの一部が配置された場所。

導入されたバージョン:

1.3

関連項目:

View

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
static class	FlowView.FlowStrategy フローの物理的なフォームを維持するための方法です。

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
protected View	layoutPool このビューが表す要素 (物理的ビューに変換する論理ビュー) の子要素を表すビューです。
protected int	layoutSpan フローが作成される際のデフォルトの制約です。
protected FlowView.FlowStrategy	strategy フローを更新し続ける動作です。

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

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

コンストラクタ

コンストラクタと説明
FlowView(Element elem, int axis) 指定された要素の FlowView を作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
protected SizeRequirements	calculateMinorAxisRequirements(int axis, SizeRequirements r) 副軸の必要サイズを計算します。
void	changedUpdate(DocumentEvent changes, Shape a, ViewFactory f) このビューが扱う位置で属性が変更されたことをドキュメントから通知します。
protected abstract View	createRow() フローの子に相当する行を保持するのに使う View を作成します。
int	getFlowAxis() それに沿ってビューをフローする軸を取得します。
int	getFlowSpan(int index) 指定された子のインデックスに反してフローする制約スパンを取得します。
int	getFlowStart(int index) フロースパンを開始する、フロー軸に沿った位置を取得します。
protected int	getViewIndexAtPosition(int pos) モデル内の指定された位置を表す子ビューのインデックスを取得します。
void	insertUpdate(DocumentEvent changes, Shape a, ViewFactory f) このビューが扱う位置でドキュメントに何かが挿入されたことを通知します。
protected void	layout(int width, int height) 子を配置します。
protected void	loadChildren(ViewFactory f) ビューを初期化するためにすべての子をロードします。
void	removeUpdate(DocumentEvent changes, Shape a, ViewFactory f) このビューが扱うドキュメント内の位置から何かが削除されたということを通知します。
void	setParent(View parent) ビューの親を設定します。

クラス javax.swing.text.BoxView から継承されたメソッド

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

クラス javax.swing.text.CompositeView から継承されたメソッド

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

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

フィールドの詳細

layoutSpan

protected int layoutSpan

フローが作成される際のデフォルトの制約です。

layoutPool

protected View layoutPool

このビューが表す要素 (物理的ビューに変換する論理ビュー) の子要素を表すビューです。このビューの直接の子ではありません。行の中に直接配置されるか、または小さなチャンクに分割して物理的ビューを形成します。

strategy

protected FlowView.FlowStrategy strategy

フローを更新し続ける動作です。デフォルトでは、すべての FlowView インスタンスが共有する単体です (FlowStrategy には状態はありません)。サブクラスは状態を保つ別の方法を作成できます。

コンストラクタの詳細

FlowView

public FlowView(Element elem,
        int axis)

指定された要素の FlowView を作成します。

パラメータ:

elem - このビューが扱う要素

axis - View.X_AXIS または View.Y_AXIS

メソッドの詳細

getFlowAxis

public int getFlowAxis()

それに沿ってビューをフローする軸を取得します。デフォルトでは、フロー行をタイリングする軸 (デフォルトのフロー行そのものの軸) と直角の軸となります。通常は FlowStrategy が使用します。

getFlowSpan

public int getFlowSpan(int index)

指定された子のインデックスに反してフローする制約スパンを取得します。フローを更新中に FlowStrategy により呼び出されます。制約行に異なった値を提供してフローを形成することもできます。デフォルトでは、フロー軸に沿ったインセットの内側の全スパンが返されます。

パラメータ:

index - 更新中の行のインデックス。0 以上で getViewCount() より小さい値であること。

関連項目:

getFlowStart(int)

getFlowStart

public int getFlowStart(int index)

フロースパンを開始する、フロー軸に沿った位置を取得します。フローを更新中に FlowStrategy により呼び出されます。制約行に異なった値を提供してフローを形成することもできます。

パラメータ:

index - 更新中の行のインデックス。0 以上で getViewCount() より小さい値であること。

関連項目:

getFlowSpan(int)

createRow

protected abstract View createRow()

フローの子に相当する行を保持するのに使う View を作成します。フロー更新中に新しい子が追加されたり、子が削除されると (行が追加されたり削除されると) FlowStrategy により呼び出されます。

loadChildren

protected void loadChildren(ViewFactory f)

ビューを初期化するためにすべての子をロードします。これは、setParent メソッドによって呼び出されます。このメソッドを再実装すると、どの子も (書式設定のプロセスで作成されるので) 直接ロードしないようにできます。layoutPool 変数が null の場合、LogicalView のインスタンスが生成され、書式設定のプロセスで使われる論理ビューを表します。

オーバーライド:

loadChildren、クラス: CompositeView

パラメータ:

f - ビューファクトリ

関連項目:

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

getViewIndexAtPosition

protected int getViewIndexAtPosition(int pos)

モデル内の指定された位置を表す子ビューのインデックスを取得します。

オーバーライド:

getViewIndexAtPosition、クラス: CompositeView

パラメータ:

pos - 位置 >= 0

戻り値:

指定された位置を表すビューのインデックス。その位置を表すビューがない場合は -1

layout

protected void layout(int width,
          int height)

子を配置します。フロー軸に沿ったスパンを変更すると、レイアウトは無効というマークが付けられスーパークラスはボックス軸に沿ったレイアウトを再計算します。FlowStrategy.layout メソッドが呼び出され、適切なフロー行を再構築します。ボックス軸に沿った望ましいサイズによって決まるビューの高さを変更すると、preferenceChanged が呼び出されます。このようにしてスーパークラスの通常のボックスレイアウトが実行されます。

オーバーライド:

layout、クラス: BoxView

パラメータ:

width - 配置する幅。0 以上。インセット領域内部の幅。

height - 配置する高さ。0 以上。インセット領域内部の高さ。

calculateMinorAxisRequirements

protected SizeRequirements calculateMinorAxisRequirements(int axis,
                                              SizeRequirements r)

副軸の必要サイズを計算します。これを実装すると、getMinimumSpan、getPreferredSpan、および getMaximumSpan を呼び出して論理ビューに要求を転送できます。

オーバーライド:

calculateMinorAxisRequirements、クラス: BoxView

パラメータ:

axis - 調査中の軸

r - SizeRequirements オブジェクト。null の場合、1 つ作成される

戻り値:

新しく初期化された SizeRequirements オブジェクト

関連項目:

SizeRequirements

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)

setParent

public void setParent(View parent)

ビューの親を設定します。このビューがまだ子を持たない場合は、loadChildren メソッドの呼び出しとともにスーパークラスの動作を提供するために実装し直されます。子をコンストラクタの中にロードしないようにしてください。これは、親を設定する動作が原因となって、たとえば収容側 Container を取得するために、子が階層をさかのぼって検索しようとするからです。このビューが子を持つ場合、ビューはビュー階層内のある位置から別の位置へ移動しているので、loadChildren メソッドは呼び出されません。

オーバーライド:

setParent、クラス: CompositeView

パラメータ:

parent - ビューの親。ない場合は null