モジュール java.desktop
パッケージ javax.swing.text

クラスTableView

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

public abstract class TableView
extends BoxView

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


    TABLE
      ROW
        CELL
        CELL
      ROW
        CELL
        CELL

 

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

関連項目:
View
  • コンストラクタの詳細

    • TableView

      public TableView​(Element elem)
      指定された要素のTableViewを作成します。
      パラメータ:
      elem - このビューが扱う要素
  • メソッドの詳細

    • createTableRow

      protected TableView.TableRow createTableRow​(Element elem)
      新しいテーブル行を作成します。
      パラメータ:
      elem - 要素
      戻り値:
    • createTableCell

      @Deprecatedprotected TableView.TableCell createTableCell​(Element elem)
      Deprecated.
      テーブル・セルは任意のView実装となることができますが、テーブルではなく、ViewFactoryによって作成されるようにします。
      パラメータ:
      elem - 要素
      戻り値:
      セル
    • 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)
      指定されたターゲット・スパンに収まるように列をレイアウトします。 offsetsspansから結果を返します。
      パラメータ:
      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