javax.swing.table
クラス TableColumn

java.lang.Object
  javax.swing.table.TableColumn

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

Serializable

public class TableColumn
extends Object
implements Serializable

TableColumn は JTable の列のすべての属性 (幅、サイズ変更可能性、最小と最大の幅など) を表します。さらに、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 で設定できます。テーブルパッケージは、DefaultTableColumnModel の getColumnIndex() で使用される 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 メソッドによってデフォルト値が提供されます。これらのメソッドは、列内の値のタイプに基づいてデフォルトを提供します。JTable の getCellRenderer メソッドをオーバーライドすることで、列中心の描画方法を回避できます。

関連項目:

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 によっては使用されず、外部的にだけ使用されます。identifier が null の場合、getIdentifier() はデフォルトで getHeaderValue を返します。

戻り値:

identifier プロパティ

関連項目:

setIdentifier(java.lang.Object)

setHeaderValue

public void setHeaderValue(Object headerValue)

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

パラメータ:

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 を返します。headerRenderer が null の場合、JTableHeader は defaultRenderer を使用します。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 が供給する値オブジェクトを解釈するためにも使用されます。cellRenderer が null の場合、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 を返します。cellEditor が null の場合は、JTable はその列のセルクラスに基づいてデフォルトのエディタを使用します。デフォルトの cellEditor は null です。

戻り値:

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) 内の列の幅を計算する方法については、JTable の doLayout メソッドを参照してください。

パラメータ:

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 をリスナーリストに追加します。リスナーは、すべてのプロパティに登録されます。

現在のコンポーネントの setFont、setBackground、または 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()