DefaultTableModel JDK 1.6)

Constructors

public DefaultTableModel ()

Constructs a default DefaultTableModel which is a table of zero columns and zero rows.

public DefaultTableModel (int rowCount, int columnCount)

Constructs a DefaultTableModel with rowCount and columnCount of null object values.

Constructs a DefaultTableModel with
rowCount and columnCount of
null object values.
Parameters:
- rowCount - the number of rows the table holds
- columnCount - the number of columns the table holds
See Also: DefaultTableModel.setValueAt(java.lang.Object, int, int),

public DefaultTableModel (Object data, Object columnNames)

Constructs a DefaultTableModel and initializes the table by passing data and columnNames to the setDataVector method.

Constructs a DefaultTableModel and initializes the table
by passing data and columnNames
to the setDataVector
method. The first index in the Object[][] array is
the row index and the second is the column index.
Parameters:
- data - the data of the table
- columnNames - the names of the columns
See Also: DefaultTableModel.getDataVector(), DefaultTableModel.setDataVector(java.util.Vector, java.util.Vector),

public DefaultTableModel (Object columnNames, int rowCount)

Constructs a DefaultTableModel with as many columns as there are elements in columnNames and rowCount of null object values.

Constructs a DefaultTableModel with as many
columns as there are elements in columnNames
and rowCount of null
object values. Each column's name will be taken from
the columnNames array.
Parameters:
- columnNames - array containing the names of the new columns; if this is null then the model has no columns
- rowCount - the number of rows the table holds
See Also: DefaultTableModel.setDataVector(java.util.Vector, java.util.Vector), DefaultTableModel.setValueAt(java.lang.Object, int, int),

public DefaultTableModel (Vector columnNames, int rowCount)

Constructs a DefaultTableModel with as many columns as there are elements in columnNames and rowCount of null object values.

Constructs a DefaultTableModel with as many columns
as there are elements in columnNames
and rowCount of null
object values. Each column's name will be taken from
the columnNames vector.
Parameters:
- columnNames - vector containing the names of the new columns; if this is null then the model has no columns
- rowCount - the number of rows the table holds
See Also: DefaultTableModel.setDataVector(java.util.Vector, java.util.Vector), DefaultTableModel.setValueAt(java.lang.Object, int, int),

public DefaultTableModel (Vector data, Vector columnNames)

Constructs a DefaultTableModel and initializes the table by passing data and columnNames to the setDataVector method.

Constructs a DefaultTableModel and initializes the table
by passing data and columnNames
to the setDataVector method.
Parameters:
- data - the data of the table, a Vector of Vectors of Object values
- columnNames - vector containing the names of the new columns
See Also: DefaultTableModel.getDataVector(), DefaultTableModel.setDataVector(java.util.Vector, java.util.Vector),

Methods

Hide/Show inherited methods

public void addColumn (Object columnName)

Adds a column to the model.

Adds a column to the model. The new column will have the
identifier columnName, which may be null. This method
will send a
tableChanged notification message to all the listeners.
This method is a cover for addColumn(Object, Vector) which
uses null as the data vector.
Parameters:
- columnName - the identifier of the column being added

public void addColumn (Object columnName, Object columnData)

Adds a column to the model.

Adds a column to the model. The new column will have the
identifier columnName. columnData is the
optional array of data for the column. If it is null
the column is filled with null values. Otherwise,
the new data will be added to model starting with the first
element going to row 0, etc. This method will send a
tableChanged notification message to all the listeners.
See Also: DefaultTableModel.addColumn(Object, Vector),

public void addColumn (Object columnName, Vector columnData)

Adds a column to the model.

Adds a column to the model. The new column will have the
identifier columnName, which may be null.
columnData is the
optional vector of data for the column. If it is null
the column is filled with null values. Otherwise,
the new data will be added to model starting with the first
element going to row 0, etc. This method will send a
tableChanged notification message to all the listeners.
Parameters:
- columnName - the identifier of the column being added
- columnData - optional data of the column being added

public void addRow (Object rowData)

Adds a row to the end of the model.

Adds a row to the end of the model. The new row will contain
null values unless rowData is specified.
Notification of the row being added will be generated.
Parameters:
- rowData - optional data of the row being added

public void addRow (Vector rowData)

Adds a row to the end of the model.

public void addTableModelListener (TableModelListener l) [Inherited From AbstractTableModel]

Adds a listener to the list that's notified each time a change to the data model occurs.

protectedstatic Vector convertToVector (Object anArray)

Returns a vector that contains the same objects as the array.

Returns a vector that contains the same objects as the array.
Returns: the new vector; if anArray is null, returns null
Parameters:
- anArray - the array to be converted

protectedstatic Vector convertToVector (Object anArray)

Returns a vector of vectors that contains the same objects as the array.

Returns a vector of vectors that contains the same objects as the array.
Returns: the new vector of vectors; if anArray is null, returns null
Parameters:
- anArray - the double array to be converted

public int findColumn (String columnName) [Inherited From AbstractTableModel]

Returns a column given its name.

Returns a column given its name.
Implementation is naive so this should be overridden if
this method is to be called often. This method is not
in the TableModel interface and is not used by the
JTable.
Returns: the column with columnName, or -1 if not found
Parameters:
- columnName - string containing name of column to be located

public void fireTableCellUpdated (int row, int column) [Inherited From AbstractTableModel]

Notifies all listeners that the value of the cell at [row, column] has been updated.

Notifies all listeners that the value of the cell at
[row, column] has been updated.
Parameters:
- row - row of cell which has been updated
- column - column of cell which has been updated
See Also: TableModelEvent, EventListenerList,

public void fireTableChanged (TableModelEvent e) [Inherited From AbstractTableModel]

Forwards the given notification event to all TableModelListeners that registered themselves as listeners for this table model.

Forwards the given notification event to all
TableModelListeners that registered
themselves as listeners for this table model.
Parameters:
- e - the event to be forwarded
See Also: AbstractTableModel.addTableModelListener(javax.swing.event.TableModelListener), TableModelEvent, EventListenerList,

public void fireTableDataChanged () [Inherited From AbstractTableModel]

Notifies all listeners that all cell values in the table's rows may have changed.

Notifies all listeners that all cell values in the table's
rows may have changed. The number of rows may also have changed
and the JTable should redraw the
table from scratch. The structure of the table (as in the order of the
columns) is assumed to be the same.
See Also: TableModelEvent, EventListenerList, JTable.tableChanged(TableModelEvent),

public void fireTableRowsDeleted (int firstRow, int lastRow) [Inherited From AbstractTableModel]

Notifies all listeners that rows in the range [firstRow, lastRow], inclusive, have been deleted.

Notifies all listeners that rows in the range
[firstRow, lastRow], inclusive, have been deleted.
Parameters:
- firstRow - the first row
- lastRow - the last row
See Also: TableModelEvent, EventListenerList,

public void fireTableRowsInserted (int firstRow, int lastRow) [Inherited From AbstractTableModel]

Notifies all listeners that rows in the range [firstRow, lastRow], inclusive, have been inserted.

Notifies all listeners that rows in the range
[firstRow, lastRow], inclusive, have been inserted.
Parameters:
- firstRow - the first row
- lastRow - the last row
See Also: TableModelEvent, EventListenerList,

public void fireTableRowsUpdated (int firstRow, int lastRow) [Inherited From AbstractTableModel]

Notifies all listeners that rows in the range [firstRow, lastRow], inclusive, have been updated.

Notifies all listeners that rows in the range
[firstRow, lastRow], inclusive, have been updated.
Parameters:
- firstRow - the first row
- lastRow - the last row
See Also: TableModelEvent, EventListenerList,

public void fireTableStructureChanged () [Inherited From AbstractTableModel]

Notifies all listeners that the table's structure has changed.

Notifies all listeners that the table's structure has changed.
The number of columns in the table, and the names and types of
the new columns may be different from the previous state.
If the JTable receives this event and its
autoCreateColumnsFromModel
flag is set it discards any table columns that it had and reallocates
default columns in the order they appear in the model. This is the
same as calling setModel(TableModel) on the
JTable.
See Also: TableModelEvent, EventListenerList,

public Class<Object> getColumnClass (int columnIndex) [Inherited From AbstractTableModel]

Returns Object.class regardless of columnIndex.

Returns Object.class regardless of columnIndex.
Returns: the Object.class
Parameters:
- columnIndex - the column being queried

public int getColumnCount ()

Returns the number of columns in this data table.

public String getColumnName (int column) [Overrides AbstractTableModel]

Returns the column name.

Returns the column name.
Returns: a name for this column using the string value of the appropriate member in columnIdentifiers. If columnIdentifiers does not have an entry for this index, returns the default name provided by the superclass.

public Vector getDataVector ()

Returns the Vector of Vectors that contains the table's data values.

Returns the Vector of Vectors that contains the table's data values. The vectors contained in the outer vector are each a single row of values. In other words, to get to the cell at row 1, column 5:

((Vector)getDataVector().elementAt(1)).elementAt(5);

Returns: the vector of vectors containing the tables data values
See Also: DefaultTableModel.newDataAvailable(javax.swing.event.TableModelEvent), DefaultTableModel.newRowsAdded(javax.swing.event.TableModelEvent), DefaultTableModel.setDataVector(java.util.Vector, java.util.Vector),

public T getListeners (Class< T> listenerType) [Inherited From AbstractTableModel]

Returns an array of all the objects currently registered as FooListeners upon this AbstractTableModel.

Returns an array of all the objects currently registered as FooListeners upon this AbstractTableModel. FooListeners are registered using the addFooListener method.

You can specify the listenerType argument with a class literal, such as FooListener.class. For example, you can query a model m for its table model listeners with the following code:

TableModelListener[] tmls = (TableModelListener[])(m.getListeners(TableModelListener.class));

If no such listeners exist, this method returns an empty array.
Returns: an array of all objects registered as FooListeners on this component, or an empty array if no such listeners have been added
Parameters:
- listenerType - the type of listeners requested; this parameter should specify an interface that descends from java.util.EventListener
Throws:
- ClassCastException - if listenerType doesn't specify a class or interface that implements java.util.EventListener
Since: 1.3
See Also: AbstractTableModel.getTableModelListeners(),

public int getRowCount ()

Returns the number of rows in this data table.

public TableModelListener getTableModelListeners () [Inherited From AbstractTableModel]

Returns an array of all the table model listeners registered on this model.

Returns an array of all the table model listeners
registered on this model.
Returns: all of this model's TableModelListeners or an empty array if no table model listeners are currently registered
Since: 1.4
See Also: AbstractTableModel.addTableModelListener(javax.swing.event.TableModelListener), AbstractTableModel.removeTableModelListener(javax.swing.event.TableModelListener),

public Object getValueAt (int row, int column)

Returns an attribute value for the cell at row and column.

Returns an attribute value for the cell at row
and column.
Returns: the value Object at the specified cell
Parameters:
- row - the row whose value is to be queried
- column - the column whose value is to be queried
Throws:
- ArrayIndexOutOfBoundsException - if an invalid row or column was given

public void insertRow (int row, Object rowData)

Inserts a row at row in the model.

Inserts a row at row in the model. The new row
will contain null values unless rowData
is specified. Notification of the row being added will be generated.
Parameters:
- row - the row index of the row to be inserted
- rowData - optional data of the row being added
Throws:
- ArrayIndexOutOfBoundsException - if the row was invalid

public void insertRow (int row, Vector rowData)

Inserts a row at row in the model.

public boolean isCellEditable (int row, int column) [Overrides AbstractTableModel]

Returns true regardless of parameter values.

public void moveRow (int start, int end, int to)

Moves one or more rows from the inclusive range start to end to the to position in the model.

Moves one or more rows from the inclusive range start to end to the to position in the model. After the move, the row that was at index start will be at index to. This method will send a tableChanged notification message to all the listeners.

  Examples of moves:
  
  1. moveRow(1,3,5);
          a|B|C|D|e|f|g|h|i|j|k   - before
          a|e|f|g|h|B|C|D|i|j|k   - after
  

  2. moveRow(6,7,1);
          a|b|c|d|e|f|G|H|i|j|k   - before
          a|G|H|b|c|d|e|f|i|j|k   - after

Parameters:
- start - the starting row index to be moved
- end - the ending row index to be moved
- to - the destination of the rows to be moved
Throws:
- ArrayIndexOutOfBoundsException - if any of the elements would be moved out of the table's range

public void newDataAvailable (TableModelEvent event)

Equivalent to fireTableChanged.

Equivalent to fireTableChanged.
Parameters:
- event - the change event

public void newRowsAdded (TableModelEvent e)

Ensures that the new rows have the correct number of columns.

Ensures that the new rows have the correct number of columns.
This is accomplished by using the setSize method in
Vector which truncates vectors
which are too long, and appends nulls if they
are too short.
This method also sends out a tableChanged
notification message to all the listeners.
Parameters:
- e - this TableModelEvent describes where the rows were added. If null it assumes all the rows were newly added
See Also: DefaultTableModel.getDataVector(),

public void removeRow (int row)

Removes the row at row from the model.

Removes the row at row from the model. Notification
of the row being removed will be sent to all the listeners.
Parameters:
- row - the row index of the row to be removed
Throws:
- ArrayIndexOutOfBoundsException - if the row was invalid

public void removeTableModelListener (TableModelListener l) [Inherited From AbstractTableModel]

Removes a listener from the list that's notified each time a change to the data model occurs.

public void rowsRemoved (TableModelEvent event)

Equivalent to fireTableChanged.

Equivalent to fireTableChanged.
Parameters:
- event - the change event

public void setColumnCount (int columnCount)

Sets the number of columns in the model.

Sets the number of columns in the model. If the new size is greater
than the current size, new columns are added to the end of the model
with null cell values.
If the new size is less than the current size, all columns at index
columnCount and greater are discarded.
Parameters:
- columnCount - the new number of columns in the model
Since: 1.3
See Also: DefaultTableModel.setColumnCount(int),

public void setColumnIdentifiers (Object newIdentifiers)

Replaces the column identifiers in the model.

Replaces the column identifiers in the model. If the number of newIdentifiers is greater than the current number of columns, new columns are added to the end of each row in the model. If the number of newIdentifiers is less than the current number of columns, all the extra columns at the end of a row are discarded.

Parameters:
- newIdentifiers - array of column identifiers. If null, set the model to zero columns
See Also: DefaultTableModel.setNumRows(int),

public void setColumnIdentifiers (Vector columnIdentifiers)

Replaces the column identifiers in the model.

Parameters:
- columnIdentifiers - vector of column identifiers. If null, set the model to zero columns
See Also: DefaultTableModel.setNumRows(int),

public void setDataVector (Object dataVector, Object columnIdentifiers)

Replaces the value in the dataVector instance variable with the values in the array dataVector.

Replaces the value in the dataVector instance
variable with the values in the array dataVector.
The first index in the Object[][]
array is the row index and the second is the column index.
columnIdentifiers are the names of the new columns.
Parameters:
- dataVector - the new data vector
- columnIdentifiers - the names of the columns
See Also: DefaultTableModel.setDataVector(Vector, Vector),

public void setDataVector (Vector dataVector, Vector columnIdentifiers)

Replaces the current dataVector instance variable with the new Vector of rows, dataVector.

Replaces the current dataVector instance variable with the new Vector of rows, dataVector. Each row is represented in dataVector as a Vector of Object values. columnIdentifiers are the names of the new columns. The first name in columnIdentifiers is mapped to column 0 in dataVector. Each row in dataVector is adjusted to match the number of columns in columnIdentifiers either by truncating the Vector if it is too long, or adding null values if it is too short.

Note that passing in a null value for dataVector results in unspecified behavior, an possibly an exception.
Parameters:
- dataVector - the new data vector
- columnIdentifiers - the names of the columns
See Also: DefaultTableModel.getDataVector(),

public void setNumRows (int rowCount)

Obsolete as of Java 2 platform v1.3.

Obsolete as of Java 2 platform v1.3. Please use setRowCount instead.

public void setRowCount (int rowCount)

Sets the number of rows in the model.

Sets the number of rows in the model. If the new size is greater than the current size, new rows are added to the end of the model If the new size is less than the current size, all rows at index rowCount and greater are discarded.

Since: 1.3
See Also: DefaultTableModel.setColumnCount(int),

public void setValueAt (Object aValue, int row, int column) [Overrides AbstractTableModel]

Sets the object value for the cell at column and row.

Sets the object value for the cell at column and
row. aValue is the new value. This method
will generate a tableChanged notification.
Parameters:
- aValue - the new value; this can be null
- row - the row whose value is to be changed
- column - the column whose value is to be changed
Throws:
- ArrayIndexOutOfBoundsException - if an invalid row or column was given