JavaTM 2 Platform
Std. Ed. v1.3

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, NORTH, NORTH_EAST, NORTH_WEST, 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, 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, getViewFactory, 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

protected TableView.TableCell createTableCell(Element elem)
推奨されていません。 テーブルセルは任意の View 実装となることができますが、テーブルではなく ViewFactory によって作成されるようにします。

パラメータ:
elem - 要素
戻り値:
セル

forwardUpdate

protected void forwardUpdate(DocumentEvent.ElementChange ec,
                             DocumentEvent e,
                             Shape a,
                             ViewFactory f)
クラス BoxView の記述:
指定された DocumentEvent をそのモデルへの変更の通知が必要な子ビューに転送します。先頭の子のボックスの部分をボックスの最後に転送する前に、子がその要件を変更しており、割り当てが有効であった場合、再ペイントされます。
オーバーライド:
クラス BoxView 内の forwardUpdate
クラス javax.swing.text.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)
子ビューを変更します。スーパークラスの動作を提供し、グリッドを無効にして行と列を計算し直すために実装されます。
オーバーライド:
クラス BoxView 内の replace
クラス javax.swing.text.BoxView からコピーされたタグ:
パラメータ:
index - 新規ビューを挿入するための、子ビューの開始インデックス。この値は 0 以上で、getViewCount 以下
length - 削除する現在の子ビューの数。この値は 0 以上で、(getViewCount() - offset) 以下
views - 追加する子ビュー。追加する子 (削除しやすい) がないことを示す場合は、null の可能性もある

layoutColumns

protected void layoutColumns(int targetSpan,
                             int[] offsets,
                             int[] spans,
                             SizeRequirements[] reqs)
指定されたターゲットスパンに収まるように列をレイアウトします。
パラメータ:
targetSpan - すべてのテーブル列の総計に指定されたスパン
reqs - 各列の必要条件。セルの最小値から導かれる列の最大値 (こちらが優先される)、および必要なスパンの最大値
spans - 各列に割り当てられたスパンの戻り値
offsets - 各列の起点からのオフセットの戻り値
戻り値:
offsets パラメータには各列の起点からのオフセット、spans パラメータには各列のスパン

layoutMinorAxis

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

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

オーバーライド:
クラス BoxView 内の layoutMinorAxis
パラメータ:
targetSpan - ビューに指定されたスパンの合計。子をレイアウトするために使用される
axis - レイアウトされる軸
offsets - 各子ビューのビューの起点からのオフセット。これは戻り値であり、このメソッドの実装によって割り当てられる
spans - 各子ビューのスパン。これは戻り値であり、このメソッドの実装によって割り当てられる
戻り値:
offsets パラメータには各子ビューのオフセット、spans パラメータには各子ビューのスパン

calculateMinorAxisRequirements

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

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

オーバーライド:
クラス BoxView 内の calculateMinorAxisRequirements

getViewAtPosition

protected View getViewAtPosition(int pos,
                                 Rectangle a)
モデル内で指定された位置を表す子ビューを取り出します。これは、指定された位置を含む範囲を探すためにすべての子を走査する目的で実装されています。このビューでは、子から子の要素へのマッピングが 1 対 1 になるとは限りません。
オーバーライド:
クラス CompositeView 内の getViewAtPosition
パラメータ:
pos - 検索位置 >= 0
a - テーブルへの入力時の割り当て。および、終了時の位置を含むビューへの割り当て
戻り値:
指定された位置を表すビュー。ない場合は null

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.