javax.swing.text

クラスTableView

java.lang.Object

javax.swing.text.View

javax.swing.text.CompositeView

javax.swing.text.BoxView

javax.swing.text.TableView

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

SwingConstants

public abstract class TableView
extends BoxView

テーブルのViewインタフェースを実装します。テーブルは、このビューが扱う要素の子要素が行を表し、行要素の子要素がセルである要素構造で構成されます。セル要素は、その下に任意の要素構造を持つことができます。この要素構造は、getViewFactoryメソッドによって返されるViewFactoryを使用して構築されます。

    TABLE
      ROW
        CELL
        CELL
      ROW
        CELL
        CELL

 

これは、ボックスの階層として実装されます。表自体は垂直のボックス、行は水平のボックス、およびセルは垂直のボックスです。セルは、複数の列および行を補うことができます。デフォルトでは、表はグリッド上で形成されているものと見なすことができ(つまり、グリッド・バッグ・レイアウトで見られるようなもの)、そこでは表のセルは複数のグリッド・セルに補うことを要求できます。表のセルのデフォルトの水平スパンはこのグリッドに基づきますが、セルの要求されたスパンを再実装することによって変更することができます(つまり、表のセルは必要な場合に独立したスパンを持つことができる)。

関連項目:

View

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

ネストされたクラス

修飾子と型	クラスと説明
class	TableView.TableCell 非推奨。 テーブル・セルは任意のView実装となることができます。
class	TableView.TableRow 行中心のテーブル内の行のビューです。

フィールドのサマリー

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

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

コンストラクタ

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

メソッドのサマリー

修飾子と型	メソッドと説明
protected SizeRequirements	calculateMinorAxisRequirements(int axis, SizeRequirements r) 副軸の必要サイズを計算します。
protected TableView.TableCell	createTableCell(Element elem) 非推奨。 テーブル・セルは任意のView実装となることができますが、テーブルではなく、ViewFactoryによって作成されるようにします。
protected TableView.TableRow	createTableRow(Element elem) 新しいテーブル行を作成します。
protected void	forwardUpdate(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a, ViewFactory f) 指定されたDocumentEventを、モデルへの変更について通知する必要のある子ビューに転送します。
protected View	getViewAtPosition(int pos, Rectangle a) モデル内で指定された位置を表す子ビューを取得します。
protected void	layoutColumns(int targetSpan, int[] offsets, int[] spans, SizeRequirements[] reqs) 指定されたターゲット・スパンに収まるように列をレイアウトします。
protected void	layoutMinorAxis(int targetSpan, int axis, int[] offsets, int[] spans) ボックスの副軸をレイアウトします。
void	replace(int offset, int length, View[] views) 子ビューを変更します。

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

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

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

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

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

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

クラス java.lang.Objectから継承されたメソッド

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

コンストラクタの詳細

TableView

public TableView(Element elem)

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

パラメータ:

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

メソッドの詳細

createTableRow

protected TableView.TableRow createTableRow(Element elem)

新しいテーブル行を作成します。

パラメータ:

elem - 要素

戻り値:

行

createTableCell

@Deprecated
protected TableView.TableCell createTableCell(Element elem)

非推奨。テーブル・セルは任意のView実装となることができますが、テーブルではなく、ViewFactoryによって作成されるようにします。

パラメータ:

elem - 要素

戻り値:

セル

forwardUpdate

protected void forwardUpdate(DocumentEvent.ElementChange ec,
                             DocumentEvent e,
                             Shape a,
                             ViewFactory f)

次のクラスからコピーされた説明: BoxView

指定されたDocumentEventを、モデルへの変更について通知する必要のある子ビューに転送します。先頭の子のボックスの部分をボックスの最後に転送する前に、子がその要件を変更しており、割当てが有効であった場合、再ペイントされます。

オーバーライド:

forwardUpdate、クラス: BoxView

パラメータ:

ec - このビューが扱う要素への変更。変更がなかった場合、nullになる可能性がある

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

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

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

関連項目:

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

replace

public void replace(int offset,
                    int length,
                    View[] views)

子ビューを変更します。スーパー・クラスの動作を提供して、グリッドを無効にして行と列を計算し直すために実装されます。

オーバーライド:

replace、クラス: BoxView

パラメータ:

offset - 新規ビューを挿入するための、子ビューの開始インデックス。この値は0以上で、getViewCount以下

length - 削除する既存の子ビューの数。この値は0以上で、(getViewCount() - offset)以下

views - 追加する子ビュー。追加される子がない場合は、nullも可(削除に便利)

layoutColumns

protected void layoutColumns(int targetSpan,
                             int[] offsets,
                             int[] spans,
                             SizeRequirements[] reqs)

指定されたターゲット・スパンに収まるように列をレイアウトします。offsetsとspansから結果を返します。

パラメータ:

targetSpan - すべてのテーブル列の総計に指定されたスパン

reqs - 各列の必要条件。セルのスパンの最小値、推奨値、および最大値から導かれる列の最大値

spans - 各列に割り当てられたスパンの戻り値

offsets - 各列の起点からのオフセットの戻り値

layoutMinorAxis

protected void layoutMinorAxis(int targetSpan,
                               int axis,
                               int[] offsets,
                               int[] spans)

ボックスの副軸(つまり、それが表す軸に直角の軸)をレイアウトします。レイアウトの結果は、副軸に沿った子への割り当てを表す指定された配列に配置されなければいけません。このメソッドは、副軸に沿ってレイアウトが更新される必要があるときにスーパー・クラスによって呼び出されます。

このメソッドは、layoutColumnsメソッドを呼び出し、続いてスーパー・クラスに転送してテーブル行のレイアウトを実際に行うために実装されます。

オーバーライド:

layoutMinorAxis、クラス: BoxView

パラメータ:

targetSpan - ビューに指定されたスパンの合計。子をレイアウトするために使用される。

axis - レイアウトされる軸。

offsets - 各子ビューのビューの起点からのオフセット。これは戻り値であり、このメソッドの実装によって割り当てられる。

spans - 各子ビューのスパン。これは戻り値であり、このメソッドの実装によって割り当てられる。

calculateMinorAxisRequirements

protected SizeRequirements calculateMinorAxisRequirements(int axis,
                                                          SizeRequirements r)

副軸の必要サイズを計算します。このメソッドは、必要サイズが更新される必要がある(つまり、このビューを介してpreferenceChangedが送られた)ときにスーパー・クラスによって呼び出されます。

このメソッドは、列の必要サイズの合計として必要サイズを計算するために実装されます。

オーバーライド:

calculateMinorAxisRequirements、クラス: BoxView

パラメータ:

axis - 調査中の軸

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

戻り値:

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

関連項目:

SizeRequirements

getViewAtPosition

protected View getViewAtPosition(int pos,
                                 Rectangle a)

モデル内で指定された位置を表す子ビューを取得します。これは、指定された位置を含む範囲を探すためにすべての子を走査する目的で実装されています。このビューでは、子から子の要素へのマッピングが1対1になるとは限りません。

オーバーライド:

getViewAtPosition、クラス: CompositeView

パラメータ:

pos - 検索位置>= 0

a - 開始時のテーブルへの割当て。および、終了時の位置を含むビューの割当て

戻り値:

指定された位置を表すビュー。存在しない場合はnull