JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.table
クラス TableColumn

java.lang.Object
  上位を拡張 javax.swing.table.TableColumn
すべての実装されたインタフェース:
Serializable

public class TableColumn
extends Object
implements Serializable

TableColumnJTable の列のすべての属性 (幅、サイズ変更可能性、最小と最大の幅など) を表します。さらに、TableColumn は、レンダリングおよびエディタに対して、この列内の値を表示および編集するために使用できるスロットを提供します。

また、列ごとではなくタイプごとにレンダリングおよびエディタを指定することも可能です (JTable クラスの setDefaultRenderer メソッドを参照)。このデフォルトの機構は、TableColumn 内のレンダリング (またはエディタ) が null のときにだけ使用されます。

TableColumn は、JTable の列と TableModel の列のリンクを格納します。modelIndex は、この列のセルのデータ値が問い合わせられる TableModel の列です。ビュー内で列が移動しても、この modelIndex は変わりません。

注: 一部の実装では、すべての TableColumnModel が一意とみなされるため、同じ TableColumn インスタンスを TableColumnModel に何度も追加しないことをお勧めします。モデルから同じ列のデータを使用して TableColumn を表示するには、同じ modelIndex を使用して新しいインスタンスを作成してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降、すべての JavaBeans の長期間の運用サポートは、java.beans パッケージに追加されています。詳細は、XMLEncoder を参照してください。

関連項目:
TableColumnModel, DefaultTableColumnModel, JTableHeader.getDefaultRenderer(), JTable.getDefaultRenderer(Class), JTable.getDefaultEditor(Class), JTable.getCellRenderer(int, int), JTable.getCellEditor(int, int)

フィールドの概要
static String CELL_RENDERER_PROPERTY
          Java 2 プラットフォーム v1.3 で廃止されました。
protected  TableCellEditor cellEditor
          列のデータセルを編集するために使用されるエディタです。
protected  TableCellRenderer cellRenderer
          列のデータセルを描画するために使用されるレンダリングです。
static String COLUMN_WIDTH_PROPERTY
          Java 2 プラットフォーム v1.3 で廃止されました。
static String HEADER_RENDERER_PROPERTY
          Java 2 プラットフォーム v1.3 で廃止されました。
static String HEADER_VALUE_PROPERTY
          Java 2 プラットフォーム v1.3 で廃止されました。
protected  TableCellRenderer headerRenderer
          列のヘッダを描画するために使用されるレンダリングです。
protected  Object headerValue
          列のヘッダ値です。
protected  Object identifier
          このオブジェクトは、JTable の描画機構が内部で使用するものではありません。
protected  boolean isResizable
          ユーザが列のサイズを変更できる場合は true です。
protected  int maxWidth
          列の最大の幅です。
protected  int minWidth
          列の最小の幅です。
protected  int modelIndex
          TableColumn が表示するモデルの列のインデックスです。
protected  int resizedPostingDisableCount
          推奨されていません。 Java 2 プラットフォーム v1.3 以降
protected  int width
          列の幅です。
 
コンストラクタの概要
TableColumn()
          デフォルトのモデルインデックスとして 0、デフォルトの幅として 75、レンダリングに null、およびエディタに null を使用するカバーメソッドです。
TableColumn(int modelIndex)
          デフォルトの幅として 75、レンダリングに null、およびエディタに null を使用するカバーメソッドです。
TableColumn(int modelIndex, int width)
          レンダリングに null、およびエディタに null を使用するカバーメソッドです。
TableColumn(int modelIndex, int width, TableCellRenderer cellRenderer, TableCellEditor cellEditor)
          TableColumn のインスタンスを modelIndex で生成および初期化します。
 
メソッドの概要
 void addPropertyChangeListener(PropertyChangeListener listener)
          PropertyChangeListener をリスナーリストに追加します。
protected  TableCellRenderer createDefaultHeaderRenderer()
          Java 2 プラットフォーム v1.3 では、TableColumn コンストラクタはこのメソッドを呼び出しません。
 void disableResizedPosting()
          推奨されていません。 Java 2 プラットフォーム v1.3 以降
 void enableResizedPosting()
          推奨されていません。 Java 2 プラットフォーム v1.3 以降
 TableCellEditor getCellEditor()
          JTable がこの列の値を編集するために使用する TableCellEditor を返します。
 TableCellRenderer getCellRenderer()
          JTable がこの列の値を描画するために使用する TableCellRenderer を返します。
 TableCellRenderer getHeaderRenderer()
          TableColumn のヘッダを描画するために使用される TableCellRenderer を返します。
 Object getHeaderValue()
          ヘッダレンダリングの値として使用される Object を返します。
 Object getIdentifier()
          この列の identifier オブジェクトを返します。
 int getMaxWidth()
          TableColumn の最大の幅を返します。
 int getMinWidth()
          TableColumn の最小の幅を返します。
 int getModelIndex()
          この列のモデルインデックスを返します。
 int getPreferredWidth()
          TableColumn の適切な幅を返します。
 PropertyChangeListener[] getPropertyChangeListeners()
          この addPropertyChangeListener() を使用して TableColumn に追加された、すべての PropertyChangeListener から成る配列を返します。
 boolean getResizable()
          ユーザが TableColumn の幅を変更できる場合に true を返します。
 int getWidth()
          TableColumn の幅を返します。
 void removePropertyChangeListener(PropertyChangeListener listener)
          PropertyChangeListener をリスナーリストから削除します。
 void setCellEditor(TableCellEditor cellEditor)
          この列のセルを編集するときに使用できるようにエディタを設定します。
 void setCellRenderer(TableCellRenderer cellRenderer)
          JTable がこの列の個々の値を描画するために使用する TableCellRenderer を設定します。
 void setHeaderRenderer(TableCellRenderer headerRenderer)
          TableColumn のヘッダを headerRenderer へ描画するために使用される TableCellRenderer を設定します。
 void setHeaderValue(Object headerValue)
          文字列表現が headerRenderer の値として使用される Object を設定します。
 void setIdentifier(Object identifier)
          TableColumn の識別子を anIdentifier に設定します。
 void setMaxWidth(int maxWidth)
          TableColumn の最大の幅を maxWidth に設定し、現在の幅および適切な幅がこの値より大きい場合はそれぞれの幅を調整します。
 void setMinWidth(int minWidth)
          TableColumn の最小の幅を minWidth に設定し、現在の幅および適切な幅がこの値より小さい場合はそれぞれの幅を調整します。
 void setModelIndex(int modelIndex)
          この列のモデルインデックスを設定します。
 void setPreferredWidth(int preferredWidth)
          列の適切な幅を preferredWidth に設定します。
 void setResizable(boolean isResizable)
          この列がサイズ変更できるかどうかを設定します。
 void setWidth(int width)
          このメソッドを使用して JTable の列の幅を設定しないでください。
 void sizeWidthToFit()
          ヘッダセルの幅に合うように、TableColumn のサイズを変更します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

COLUMN_WIDTH_PROPERTY

public static final String COLUMN_WIDTH_PROPERTY
Java 2 プラットフォーム v1.3 で廃止されました。プロパティを指定するにはリテラル文字列を使用してください。

関連項目:
定数フィールド値

HEADER_VALUE_PROPERTY

public static final String HEADER_VALUE_PROPERTY
Java 2 プラットフォーム v1.3 で廃止されました。プロパティを指定するにはリテラル文字列を使用してください。

関連項目:
定数フィールド値

HEADER_RENDERER_PROPERTY

public static final String HEADER_RENDERER_PROPERTY
Java 2 プラットフォーム v1.3 で廃止されました。プロパティを指定するにはリテラル文字列を使用してください。

関連項目:
定数フィールド値

CELL_RENDERER_PROPERTY

public static final String CELL_RENDERER_PROPERTY
Java 2 プラットフォーム v1.3 で廃止されました。プロパティを指定するにはリテラル文字列を使用してください。

関連項目:
定数フィールド値

modelIndex

protected int modelIndex
TableColumn が表示するモデルの列のインデックスです。ビュー内で列が移動しても、modelIndex は変わりません。


identifier

protected Object identifier
このオブジェクトは、JTable の描画機構が内部で使用するものではありません。識別子は、テーブルコラムにタグを付けたり、検索したりする 1 つの方法として、TableColumn で設定できます。テーブルパッケージは、DefaultTableColumnModelgetColumnIndex() で使用される equals メソッドを除いて、それらの識別子オブジェクトでメソッドの変更や、呼び出しを行うことはありません。


width

protected int width
列の幅です。


minWidth

protected int minWidth
列の最小の幅です。


maxWidth

protected int maxWidth
列の最大の幅です。


headerRenderer

protected TableCellRenderer headerRenderer
列のヘッダを描画するために使用されるレンダリングです。


headerValue

protected Object headerValue
列のヘッダ値です。


cellRenderer

protected TableCellRenderer cellRenderer
列のデータセルを描画するために使用されるレンダリングです。


cellEditor

protected TableCellEditor cellEditor
列のデータセルを編集するために使用されるエディタです。


isResizable

protected boolean isResizable
ユーザが列のサイズを変更できる場合は true です。デフォルトは true です。


resizedPostingDisableCount

@Deprecated
protected transient int resizedPostingDisableCount
推奨されていません。 Java 2 プラットフォーム v1.3 以降
このフィールドは旧リリースでは使用されておらず、現在のところ将来サポートする計画もありません。

コンストラクタの詳細

TableColumn

public TableColumn()
デフォルトのモデルインデックスとして 0、デフォルトの幅として 75、レンダリングに null、およびエディタに null を使用するカバーメソッドです。このメソッドは、直列化に使用することを想定しています。 @see #TableColumn(int, int, TableCellRenderer, TableCellEditor)


TableColumn

public TableColumn(int modelIndex)
デフォルトの幅として 75、レンダリングに null、およびエディタに null を使用するカバーメソッドです。 @see #TableColumn(int, int, TableCellRenderer, TableCellEditor)


TableColumn

public TableColumn(int modelIndex,
                   int width)
レンダリングに null、およびエディタに null を使用するカバーメソッドです。 @see #TableColumn(int, int, TableCellRenderer, TableCellEditor)


TableColumn

public TableColumn(int modelIndex,
                   int width,
                   TableCellRenderer cellRenderer,
                   TableCellEditor cellEditor)
TableColumn のインスタンスを modelIndex で生成および初期化します。すべての TableColumn コンストラクタはこれに処理を委譲します。modelIndex は、テーブルのこの列のデータを供給するモデルの列のインデックスです。modelIndex は、ビューの中で列が並べ変えられても変更されません。幅のパラメータは、この列に対する preferredWidth と初期幅の両方を設定するために使用されます。レンダリングとエディタは、列内の値をそれぞれ描画および編集するために使用されるオブジェクトです。これらが null の場合は、JTable クラスの getDefaultRenderer メソッドおよび getDefaultEditor メソッドによってデフォルト値が提供されます。これらのメソッドは、列内の値のタイプに基づいてデフォルトを提供します。JTablegetCellRenderer メソッドをオーバーライドすることで、列中心の描画方法を回避できます。

関連項目:
JTable.getDefaultRenderer(Class), JTable.getDefaultEditor(Class), JTable.getCellRenderer(int, int), JTable.getCellEditor(int, int)
メソッドの詳細

setModelIndex

public void setModelIndex(int modelIndex)
この列のモデルインデックスを設定します。モデルインデックスは、この TableColumn が表示するモデルの列のインデックスです。TableColumn がビュー内で移動しても、モデルインデックスは変わりません。

パラメータ:
modelIndex - 新しいモデルインデックス

getModelIndex

public int getModelIndex()
この列のモデルインデックスを返します。

戻り値:
modelIndex プロパティ

setIdentifier

public void setIdentifier(Object identifier)
TableColumn の識別子を anIdentifier に設定します。

注: 識別子は JTable によっては使用されず、列の外部タグ付けおよび検索のためだけに使用されます。

パラメータ:
identifier - この列の識別子
関連項目:
getIdentifier()

getIdentifier

public Object getIdentifier()
この列の identifier オブジェクトを返します。識別子は JTable によっては使用されず、外部的にだけ使用されます。identifiernull の場合、getIdentifier() はデフォルトで getHeaderValue を返します。

戻り値:
identifier プロパティ
関連項目:
setIdentifier(java.lang.Object)

setHeaderValue

public void setHeaderValue(Object headerValue)
文字列表現が headerRenderer の値として使用される Object を設定します。TableColumn が生成されるときのデフォルト headerValuenull です。

パラメータ:
headerValue - 新規の headerValue
関連項目:
getHeaderValue()

getHeaderValue

public Object getHeaderValue()
ヘッダレンダリングの値として使用される Object を返します。

戻り値:
headerValue プロパティ
関連項目:
setHeaderValue(java.lang.Object)

setHeaderRenderer

public void setHeaderRenderer(TableCellRenderer headerRenderer)
TableColumn のヘッダを headerRenderer へ描画するために使用される TableCellRenderer を設定します。

パラメータ:
headerRenderer - 新規の headerRenderer
関連項目:
getHeaderRenderer()

getHeaderRenderer

public TableCellRenderer getHeaderRenderer()
TableColumn のヘッダを描画するために使用される TableCellRenderer を返します。headerRenderernull の場合、JTableHeaderdefaultRenderer を使用します。headerRenderer のデフォルト値は、null です。

戻り値:
headerRenderer プロパティ
関連項目:
setHeaderRenderer(javax.swing.table.TableCellRenderer), setHeaderValue(java.lang.Object), JTableHeader.getDefaultRenderer()

setCellRenderer

public void setCellRenderer(TableCellRenderer cellRenderer)
JTable がこの列の個々の値を描画するために使用する TableCellRenderer を設定します。

パラメータ:
cellRenderer - 新しい cellRenderer
関連項目:
getCellRenderer()

getCellRenderer

public TableCellRenderer getCellRenderer()
JTable がこの列の値を描画するために使用する TableCellRenderer を返します。列の cellRenderer は、列の表示を制御するだけでなく、TableModel が供給する値オブジェクトを解釈するためにも使用されます。cellRenderernull の場合、JTable はその列のセルクラスに基づいたデフォルトのレンダリングを使用します。cellRenderer のデフォルト値は null です。

戻り値:
cellRenderer プロパティ
関連項目:
setCellRenderer(javax.swing.table.TableCellRenderer), JTable.setDefaultRenderer(java.lang.Class, javax.swing.table.TableCellRenderer)

setCellEditor

public void setCellEditor(TableCellEditor cellEditor)
この列のセルを編集するときに使用できるようにエディタを設定します。

パラメータ:
cellEditor - 新規の cellEditor
関連項目:
getCellEditor()

getCellEditor

public TableCellEditor getCellEditor()
JTable がこの列の値を編集するために使用する TableCellEditor を返します。cellEditornull の場合は、JTable はその列のセルクラスに基づいてデフォルトのエディタを使用します。デフォルトの cellEditornull です。

戻り値:
cellEditor プロパティ
関連項目:
setCellEditor(javax.swing.table.TableCellEditor), JTable.setDefaultEditor(java.lang.Class, javax.swing.table.TableCellEditor)

setWidth

public void setWidth(int width)
このメソッドを使用して JTable の列の幅を設定しないでください。代わりに setPreferredWidth を使用します。AWT のレイアウトマネージャと同様に、テーブル自体がサイズを変更した場合や、列の適切な幅が変更された場合、JTable は必ず自動的に列の幅を調整します。したがって、プログラムで幅を設定しても、長くは影響しません。

このメソッドは、列の幅を width に設定します。width が幅の最小値または最大値を超える場合は、適切な制限値に調整されます。

パラメータ:
width - 新規の幅
関連項目:
getWidth(), setMinWidth(int), setMaxWidth(int), setPreferredWidth(int), JTable.sizeColumnsToFit(int)

getWidth

public int getWidth()
TableColumn の幅を返します。デフォルトの幅は 75 です。

戻り値:
width プロパティ
関連項目:
setWidth(int)

setPreferredWidth

public void setPreferredWidth(int preferredWidth)
列の適切な幅を preferredWidth に設定します。preferredWidth が幅の最小値または最大値を超える場合は、適切な制限値に調整されます。

preferredWidth から JTable (および JTableHeader) 内の列の幅を計算する方法については、JTabledoLayout メソッドを参照してください。

パラメータ:
preferredWidth - 新規に設定された適切な幅
関連項目:
getPreferredWidth(), JTable.doLayout()

getPreferredWidth

public int getPreferredWidth()
TableColumn の適切な幅を返します。デフォルトでは、75 です。

戻り値:
preferredWidth プロパティ
関連項目:
setPreferredWidth(int)

setMinWidth

public void setMinWidth(int minWidth)
TableColumn の最小の幅を minWidth に設定し、現在の幅および適切な幅がこの値より小さい場合はそれぞれの幅を調整します。

パラメータ:
minWidth - 新規の最小の幅
関連項目:
getMinWidth(), setPreferredWidth(int), setMaxWidth(int)

getMinWidth

public int getMinWidth()
TableColumn の最小の幅を返します。TableColumn の幅は、ユーザによっても、プログラムによっても、この値より小さくできません。デフォルトの最小幅は 15 です。

戻り値:
minWidth プロパティ
関連項目:
setMinWidth(int)

setMaxWidth

public void setMaxWidth(int maxWidth)
TableColumn の最大の幅を maxWidth に設定し、現在の幅および適切な幅がこの値より大きい場合はそれぞれの幅を調整します。

パラメータ:
maxWidth - 新規の最大の幅
関連項目:
getMaxWidth(), setPreferredWidth(int), setMinWidth(int)

getMaxWidth

public int getMaxWidth()
TableColumn の最大の幅を返します。TableColumn の幅は、ユーザによっても、プログラムによっても、この値より大きくできません。デフォルトの最大幅は Integer.MAX_VALUE です。

戻り値:
maxWidth プロパティ
関連項目:
setMaxWidth(int)

setResizable

public void setResizable(boolean isResizable)
この列がサイズ変更できるかどうかを設定します。

パラメータ:
isResizable - サイズ変更できる場合は true、そうでない場合は false
関連項目:
getResizable()

getResizable

public boolean getResizable()
ユーザが TableColumn の幅を変更できる場合に true を返します。そうでない場合は false を返します。この設定に関係なく、プログラムによって幅を変更できます。デフォルトは true です。

戻り値:
isResizable プロパティ
関連項目:
setResizable(boolean)

sizeWidthToFit

public void sizeWidthToFit()
ヘッダセルの幅に合うように、TableColumn のサイズを変更します。ヘッダレンダリングがデフォルトの null の場合、このメソッドは何も行いません。そうでない場合、この列の最小幅、最大幅、適正幅は、ヘッダレンダリングで送信された Component の最小サイズ、最大サイズ、適正サイズに設定されます。この TableColumn の一時的な「幅」のプロパティは、適正幅に設定されます。このメソッドは、テーブルパッケージによって内部的に使われません。

関連項目:
setPreferredWidth(int)

disableResizedPosting

@Deprecated
public void disableResizedPosting()
推奨されていません。 Java 2 プラットフォーム v1.3 以降

このフィールドは旧リリースでは使用されておらず、現在のところ将来サポートする計画もありません。


enableResizedPosting

@Deprecated
public void enableResizedPosting()
推奨されていません。 Java 2 プラットフォーム v1.3 以降

このフィールドは旧リリースでは使用されておらず、現在のところ将来サポートする計画もありません。


addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストに追加します。リスナーは、すべてのプロパティに登録されます。

現在のコンポーネントの setFontsetBackground、または setForeground への明示的な呼び出しに応じて、PropertyChangeEvent がトリガされます。ただし、現在のコンポーネントがそのフォアグラウンド、バックグラウンド、またはフォントをコンテナから継承している場合は、継承したプロパティの変更に応じてトリガされるイベントはありません。

パラメータ:
listener - 追加されるリスナー

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストから削除します。これは、すべてのプロパティで登録された PropertyChangeListener を削除します。

パラメータ:
listener - 削除されるリスナー

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()
この addPropertyChangeListener() を使用して TableColumn に追加された、すべての PropertyChangeListener から成る配列を返します。

戻り値:
追加されたすべての PropertyChangeListener。リスナーが追加されていない場合は空の配列
導入されたバージョン:
1.4

createDefaultHeaderRenderer

protected TableCellRenderer createDefaultHeaderRenderer()
Java 2 プラットフォーム v1.3 では、TableColumn コンストラクタはこのメソッドを呼び出しません。以前は TableColumn がこのメソッドを使用してデフォルトのヘッダレンダリングを生成しました。Java 2 platform v1.3 では、デフォルトのヘッダレンダリングは null です。現在は、JTableHeader が固有の共有デフォルトレンダリングを提供します。これは、JTable がセルレンダリングを提供するのと同様です。

戻り値:
デフォルトのヘッダレンダリング
関連項目:
JTableHeader.createDefaultRenderer()

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。