JavaTM 2 Platform
Std. Ed. v1.3

javax.swing.table
クラス DefaultTableColumnModel

java.lang.Object
  |
  +--javax.swing.table.DefaultTableColumnModel
すべての実装インタフェース:
EventListener, ListSelectionListener, PropertyChangeListener, Serializable, TableColumnModel

public class DefaultTableColumnModel
extends Object
implements TableColumnModel, PropertyChangeListener, ListSelectionListener, Serializable

JTable の標準の列ハンドラです。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:
JTable, 直列化された形式

フィールドの概要
protected  ChangeEvent changeEvent
          変更イベントです (1 つだけ必要)。
protected  int columnMargin
          各列の間の幅マージンです。
protected  boolean columnSelectionAllowed
          この列モデルで許可される列の選択です。
protected  EventListenerList listenerList
          TableColumnModelListener のリストです。
protected  ListSelectionModel selectionModel
          列選択の履歴を記録するためのモデルです。
protected  Vector tableColumns
          このモデルの TableColumn オブジェクトの配列です。
protected  int totalColumnWidth
          すべての列の結合幅のローカルなキャッシュです。
 
コンストラクタの概要
DefaultTableColumnModel()
          デフォルトのテーブル列モデルを作成します。
 
メソッドの概要
 void addColumn(TableColumn aColumn)
          tableColumns 配列の最後に aColumn を追加します。
 void addColumnModelListener(TableColumnModelListener x)
          テーブル列モデルイベント用のリスナーを追加します。
protected  ListSelectionModel createSelectionModel()
          新規のリスト選択のデフォルトモデルを作成します。
protected  void fireColumnAdded(TableColumnModelEvent e)
          このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。
protected  void fireColumnMarginChanged()
          このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。
protected  void fireColumnMoved(TableColumnModelEvent e)
          このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。
protected  void fireColumnRemoved(TableColumnModelEvent e)
          このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。
protected  void fireColumnSelectionChanged(ListSelectionEvent e)
          このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。
 TableColumn getColumn(int columnIndex)
          columnIndex にある列の TableColumn オブジェクトを返します。
 int getColumnCount()
          この tableColumns 配列の列数を返します。
 int getColumnIndex(Object identifier)
          equals を使って比較したときに識別子が identifier と等しい、tableColumns 配列にある最初の列のインデックスを返します。
 int getColumnIndexAtX(int x)
          x 位置にある列のインデックスを返します。
 int getColumnMargin()
          TableColumn の幅マージンを返します。
 Enumeration getColumns()
          モデルのすべての列の Enumeration を返します。
 boolean getColumnSelectionAllowed()
          列の選択が許可されている場合は true、そうでない場合は false を返します。
 EventListener[] getListeners(Class listenerType)
          このモデルに追加された、指定されたタイプのリスナーすべての配列を返します。
 int getSelectedColumnCount()
          選択されている列の数を返します。
 int[] getSelectedColumns()
          選択された列の配列を返します。
 ListSelectionModel getSelectionModel()
          列の選択状態を維持するために使われる ListSelectionModel を返します。
 int getTotalColumnWidth()
          すべての列の幅を組合わせた合計を返します。
 void moveColumn(int columnIndex, int newIndex)
          columnIndex にある列およびヘッダを newIndex に移動します。
 void propertyChange(PropertyChangeEvent evt)
          プロパティ変更リスナー変更メソッドです。
protected  void recalcWidthCache()
          すべての列の幅を組合わせた合計を再計算します。
 void removeColumn(TableColumn column)
          tableColumns 配列から column を削除します。
 void removeColumnModelListener(TableColumnModelListener x)
          テーブル列モデルイベント用のリスナーを削除します。
 void setColumnMargin(int newMargin)
          列マージンを newMargin に設定します。
 void setColumnSelectionAllowed(boolean flag)
          列の選択が許可されているかどうかを設定します。
 void setSelectionModel(ListSelectionModel newModel)
          この TableColumnModel の選択モデルを newModel に設定し、新しい選択モデルからのリスナー通知を登録します。
 void valueChanged(ListSelectionEvent e)
          ListSelectionListener は、列の選択を変更するときに、ListSelectionEvent を転送します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

tableColumns

protected Vector tableColumns
このモデルの TableColumn オブジェクトの配列です。

selectionModel

protected ListSelectionModel selectionModel
列選択の履歴を記録するためのモデルです。

columnMargin

protected int columnMargin
各列の間の幅マージンです。

listenerList

protected EventListenerList listenerList
TableColumnModelListener のリストです。

changeEvent

protected transient ChangeEvent changeEvent
変更イベントです (1 つだけ必要)。

columnSelectionAllowed

protected boolean columnSelectionAllowed
この列モデルで許可される列の選択です。

totalColumnWidth

protected int totalColumnWidth
すべての列の結合幅のローカルなキャッシュです。
コンストラクタの詳細

DefaultTableColumnModel

public DefaultTableColumnModel()
デフォルトのテーブル列モデルを作成します。
メソッドの詳細

addColumn

public void addColumn(TableColumn aColumn)
tableColumns 配列の最後に aColumn を追加します。また、このメソッドはそのリスナーに columnAdded イベントを送ります。
定義:
インタフェース TableColumnModel 内の addColumn
パラメータ:
column - 追加される TableColumn
例外:
IllegalArgumentException - aColumnnull の場合
関連項目:
removeColumn(javax.swing.table.TableColumn)

removeColumn

public void removeColumn(TableColumn column)
tableColumns 配列から column を削除します。column がテーブルの列リストにない場合、このメソッドは処理をしません。tile は、ヘッダおよびテーブルのビューをサイズ変更するために呼び出されます。また、このメソッドはそのリスナーに columnRemoved イベントを送ります。
定義:
インタフェース TableColumnModel 内の removeColumn
パラメータ:
column - 削除される TableColumn
関連項目:
addColumn(javax.swing.table.TableColumn)

moveColumn

public void moveColumn(int columnIndex,
                       int newIndex)
columnIndex にある列およびヘッダを newIndex に移動します。移動前は columnIndex にあった列は newIndex に置かれます。この場所を作るため、newIndex にこれまであった列は、左または右に移動します。columnIndexnewIndex が同じ場合、列は移動しません。また、このメソッドはそのリスナーに columnMoved イベントを送ります。
定義:
インタフェース TableColumnModel 内の moveColumn
パラメータ:
columnIndex - 移動する列のインデックス
newIndex - 列を移動する新規インデックス
例外:
IllegalArgumentException - column または newIndex が有効な範囲外の場合

setColumnMargin

public void setColumnMargin(int newMargin)
列マージンを newMargin に設定します。また、このメソッドはそのリスナーに columnMarginChanged イベントを送ります。
定義:
インタフェース TableColumnModel 内の setColumnMargin
パラメータ:
newMargin - ピクセル単位の新規のマージン幅
関連項目:
getColumnMargin(), getTotalColumnWidth()

getColumnCount

public int getColumnCount()
この tableColumns 配列の列数を返します。
定義:
インタフェース TableColumnModel 内の getColumnCount
戻り値:
この tableColumns 配列の列数
関連項目:
getColumns()

getColumns

public Enumeration getColumns()
モデルのすべての列の Enumeration を返します。
定義:
インタフェース TableColumnModel 内の getColumns
戻り値:
モデルの列の Enumeration

getColumnIndex

public int getColumnIndex(Object identifier)
equals を使って比較したときに識別子が identifier と等しい、tableColumns 配列にある最初の列のインデックスを返します。
定義:
インタフェース TableColumnModel 内の getColumnIndex
パラメータ:
identifier - 識別子オブジェクト
戻り値:
識別子が identifier と等しい tableColumns 配列にある、最初の列のインデックス
例外:
IllegalArgumentException - identifiernull の場合、またはこの identifier を持つ TableColumn がない場合
関連項目:
getColumn(int)

getColumn

public TableColumn getColumn(int columnIndex)
columnIndex にある列の TableColumn オブジェクトを返します。
定義:
インタフェース TableColumnModel 内の getColumn
パラメータ:
columnIndex - 要求する列のインデックス
戻り値:
columnIndex にある列の TableColumn オブジェクト

getColumnMargin

public int getColumnMargin()
TableColumn の幅マージンを返します。デフォルトの columnMargin は 1 です。
定義:
インタフェース TableColumnModel 内の getColumnMargin
戻り値:
TableColumn の最大幅
関連項目:
setColumnMargin(int)

getColumnIndexAtX

public int getColumnIndexAtX(int x)
x 位置にある列のインデックスを返します。このポイントが列の範囲外にある場合は -1 を返します。
定義:
インタフェース TableColumnModel 内の getColumnIndexAtX
パラメータ:
x - 対象の水平方向の位置
戻り値:
列のインデックス。列が見つからない場合は -1

getTotalColumnWidth

public int getTotalColumnWidth()
すべての列の幅を組合わせた合計を返します。
定義:
インタフェース TableColumnModel 内の getTotalColumnWidth
戻り値:
totalColumnWidth プロパティ

setSelectionModel

public void setSelectionModel(ListSelectionModel newModel)
この TableColumnModel の選択モデルを newModel に設定し、新しい選択モデルからのリスナー通知を登録します。newModelnull の場合、例外がスローされます。
定義:
インタフェース TableColumnModel 内の setSelectionModel
パラメータ:
newModel - 新しい選択モデル
例外:
IllegalArgumentException - newModelnull の場合
関連項目:
getSelectionModel()

getSelectionModel

public ListSelectionModel getSelectionModel()
列の選択状態を維持するために使われる ListSelectionModel を返します。
定義:
インタフェース TableColumnModel 内の getSelectionModel
戻り値:
列の選択状態を提供するオブジェクト。行の選択が許可されていない場合は null
関連項目:
setSelectionModel(javax.swing.ListSelectionModel)

setColumnSelectionAllowed

public void setColumnSelectionAllowed(boolean flag)
列の選択が許可されているかどうかを設定します。デフォルトは false です。
定義:
インタフェース TableColumnModel 内の setColumnSelectionAllowed
パラメータ:
true - 列の選択が許可される場合は true、そうでない場合は false

getColumnSelectionAllowed

public boolean getColumnSelectionAllowed()
列の選択が許可されている場合は true、そうでない場合は false を返します。デフォルトは false です。
定義:
インタフェース TableColumnModel 内の getColumnSelectionAllowed
戻り値:
columnSelectionAllowed プロパティ

getSelectedColumns

public int[] getSelectedColumns()
選択された列の配列を返します。selectionModelnull の場合、空の配列が返されます。
定義:
インタフェース TableColumnModel 内の getSelectedColumns
戻り値:
選択された列の配列。何も選択されていないか、selectionModelnull の場合は空の配列

getSelectedColumnCount

public int getSelectedColumnCount()
選択されている列の数を返します。
定義:
インタフェース TableColumnModel 内の getSelectedColumnCount
戻り値:
選択されている列の数

addColumnModelListener

public void addColumnModelListener(TableColumnModelListener x)
テーブル列モデルイベント用のリスナーを追加します。
定義:
インタフェース TableColumnModel 内の addColumnModelListener
パラメータ:
x - TableColumnModelListener オブジェクト

removeColumnModelListener

public void removeColumnModelListener(TableColumnModelListener x)
テーブル列モデルイベント用のリスナーを削除します。
定義:
インタフェース TableColumnModel 内の removeColumnModelListener
パラメータ:
x - TableColumnModelListener オブジェクト

fireColumnAdded

protected void fireColumnAdded(TableColumnModelEvent e)
このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。fire メソッドに渡されたパラメータを使用して、イベントのインスタンスはゆっくりと生成されます。
パラメータ:
e - 受け取ったイベント
関連項目:
EventListenerList

fireColumnRemoved

protected void fireColumnRemoved(TableColumnModelEvent e)
このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。fire メソッドに渡されたパラメータを使用して、イベントのインスタンスはゆっくりと生成されます。
パラメータ:
e - 受け取ったイベント
関連項目:
EventListenerList

fireColumnMoved

protected void fireColumnMoved(TableColumnModelEvent e)
このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。fire メソッドに渡されたパラメータを使用して、イベントのインスタンスはゆっくりと生成されます。
パラメータ:
e - 受け取ったイベント
関連項目:
EventListenerList

fireColumnSelectionChanged

protected void fireColumnSelectionChanged(ListSelectionEvent e)
このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。fire メソッドに渡されたパラメータを使用して、イベントのインスタンスはゆっくりと生成されます。
パラメータ:
e - 受け取ったイベント
関連項目:
EventListenerList

fireColumnMarginChanged

protected void fireColumnMarginChanged()
このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。fire メソッドに渡されたパラメータを使用して、イベントのインスタンスはゆっくりと生成されます。
パラメータ:
e - 受け取ったイベント
関連項目:
EventListenerList

getListeners

public EventListener[] getListeners(Class listenerType)
このモデルに追加された、指定されたタイプのリスナーすべての配列を返します。
パラメータ:
listenerType - 一致するリスナークラス
戻り値:
このモデルから listenerType 通知を受け取ったすべてのオブジェクト
導入されたバージョン:
1.3

propertyChange

public void propertyChange(PropertyChangeEvent evt)
プロパティ変更リスナー変更メソッドです。指定された列幅または最適な列幅への変更を追跡する場合に使用します。
定義:
インタフェース PropertyChangeListener 内の propertyChange
パラメータ:
evt - PropertyChangeEvent

valueChanged

public void valueChanged(ListSelectionEvent e)
ListSelectionListener は、列の選択を変更するときに、ListSelectionEvent を転送します。
定義:
インタフェース ListSelectionListener 内の valueChanged
パラメータ:
e - 変更イベント

createSelectionModel

protected ListSelectionModel createSelectionModel()
新規のリスト選択のデフォルトモデルを作成します。

recalcWidthCache

protected void recalcWidthCache()
すべての列の幅を組合わせた合計を再計算します。totalColumnWidth プロパティを更新します。

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.