Class com.ibm.db.selector.CellRangeSelector
java.lang.Object
|
+----com.ibm.db.selector.Selector
|
+----com.ibm.db.selector.CellRangeSelector
- public class CellRangeSelector
- implements TableModel
- extends Selector
This class
provides access to a contiguous two dimensional subset of data contained
within an implementation of the TableModel interface.
It provides the means to
change the selected subset, and to coerce the selected values
to an alternative data type. Data coercion maximizes the opportunity
for connecting a selector bean to other beans.
Data values may be obtained or supplied as a two dimensional array,
or as an array of Vectors, or as a Vector of Vectors.
This class also implements the com.sun.java.swing.table.TableModel interface,
so it can be directly used as the model for a JTable.
To control the cells within the source TableModel that are of interest,
use the
setStartColumnNumber(int)
,
setMaximumColumns(int)
,
setStartRowNumber(int)
and setMaximumRows(int)
methods.
- See Also:
- setStartColumnNumber
- setMaximumColumns
- setStartRowNumber
- setMaximumRows
- Selector
Constructor Index
- CellRangeSelector()
- Create a CellRangeSelector.
- CellRangeSelector(TableModel)
- Create a CellRangeSelector using the supplied
TableModel
.
Method Index
- addTableModelListener(TableModelListener)
- Add the supplied TableModelListener to the set of listeners to receive
TableModelEvents.
- getBigDecimal()
- Return the current selection from the source TableModel
as a
java.math.BigDecimal[][]
.
- getBigInteger()
- Return the current selection from the source TableModel
as a
java.math.BigInteger[][]
.
- getBoolean()
- Return the current selection from the source TableModel
as a
boolean[][]
.
- getByte()
- Return the current selection from the source TableModel
as a
byte[][]
.
- getByteArray()
- Return the current selection from the source TableModel
as a
byte[][][]
.
- getColumnClass(int)
- Return the class of the column addressed by this selector
at the supplied
columnIndex
.
- getColumnCount()
- Return the number of columns addressed by the CellRangeSelector.
- getColumnName(int)
- Return the name of the column addressed by this selector.
- getColumnNames()
- Return a String[] containing the names of the columns currently
referenced by this selector.
- getDate()
- Return the current selection from the source TableModel
as a
java.sql.Date[][]
.
- getDouble()
- Return the current selection from the source TableModel
as a
double[][]
.
- getFloat()
- Return the current selection from the source TableModel
as a
float[][]
.
- getIncludeColumnNames()
- Return whether the column names are to be included as
the first elements of column data obtained as String values.
- getInt()
- Return the current selection from the source TableModel
as an
int[][]
.
- getInvertData()
- Return whether the data values are to be inverted row against
column during retrieval from, or update to, the source TableModel.
- getLong()
- Return the current selection from the source TableModel
as a
long[][]
.
- getMaximumColumns()
- Return the maximum number of columns to be selected, or
Selector.NO_MAXIMUM
if the selection should extend to the
last available column.
- getMaximumRows()
- Return the maximum number of rows to be selected, or
Selector.NO_MAXIMUM
if the selection should extend to the
last available row.
- getObject()
- Return the current selection from the source TableModel
as an
Object[][][]
.
- getRowCount()
- Return the number of rows addressed by the CellRangeSelector.
- getShort()
- Return the current selection from the source TableModel
as a
short[][]
.
- getStartColumnNumber()
- Return the index number of the first column for the currently selected cells,
adjusted according to the current value of
getIndexFromOne()
.
- getStartRowNumber()
- Return the index number of the first row for the currently selected cells,
adjusted according to the current value of
getIndexFromOne()
.
- getString()
- Return the current selection from the source TableModel
as a
String[][][]
.
- getTime()
- Return the current selection from the source TableModel
as a
java.sql.Time[][]
.
- getTimestamp()
- Return the current selection from the source TableModel
as a
java.sql.Timestamp[][]
.
- getValueAt(int, int)
- Return the value at the supplied cell location.
- getVectorArray()
- Return the current selection from the source TableModel
as a
Vector[]
.
- getVectorOfVectors()
- Return the current selection from the source TableModel
as a Vector of Vectors.
- isCellEditable(int, int)
- Return whether the value at the supplied cell location is editable.
- removeTableModelListener(TableModelListener)
- Remove the supplied TableModelListener from the set of listeners to receive
TableModelEvents.
- setBigDecimal(BigDecimal[][])
- Update the current selection using the supplied
java.math.BigDecimal[][]
.
- setBigInteger(BigInteger[][])
- Update the current selection using the supplied
java.math.BigInteger[][]
.
- setBoolean(boolean[][])
- Update the current selection using the supplied
boolean[][]
.
- setByte(byte[][])
- Update the current selection using the supplied
byte[][]
.
- setByteArray(byte[][][])
- Update the current selection using the supplied
byte[][][]
.
- setDate(Date[][])
- Update the current selection using the supplied
java.sql.Date[][]
.
- setDouble(double[][])
- Update the current selection using the supplied
double[][]
.
- setFloat(float[][])
- Update the current selection using the supplied
float[][]
.
- setIncludeColumnNames(boolean)
- Specify whether the column names are to be included as
the first element of column data.
- setInt(int[][])
- Update the current selection using the supplied
int[][]
.
- setInvertData(boolean)
- Specify whether the data values are to be inverted row against
column during retrieval from, or update to, the source TableModel.
- setLong(long[][])
- Update the current selection using the supplied
long[][]
.
- setMaximumColumns(int)
- Specify the maximum number of columns to be selected.
- setMaximumRows(int)
- Specify the maximum number of rows to be selected.
- setObject(Object[][])
- Update the current selection using the supplied
Object[][][]
.
- setShort(short[][])
- Update the current selection using the supplied
short[][]
.
- setStartColumnNumber(int)
- Specify the index number of the first column for the currently selected cells.
- setStartRowNumber(int)
- Specify the index number of the first row for the currently selected cells.
- setString(String[][])
- Update the current selection using the supplied
String[][][]
.
- setTime(Time[][])
- Update the current selection using the supplied
java.sql.Time[][]
.
- setTimestamp(Timestamp[][])
- Update the current selection using the supplied
java.sql.Timestamp[][]
.
- setValueAt(Object, int, int)
- Set the value at the supplied cell location using the supplied
value.
- setVectorArray(Vector[])
- Update the current selection using the supplied
Vector[]
.
- setVectorOfVectors(Vector)
- Update the current selection using the supplied
Vector of Vectors.
Constructors
CellRangeSelector
public CellRangeSelector()
- Create a CellRangeSelector. The CellRangeSelector has no data until
setModel
is called.
- See Also:
- setModel
CellRangeSelector
public CellRangeSelector(TableModel model)
- Create a CellRangeSelector using the supplied
TableModel
.
- Parameters:
- model - the TableModel to be used as the source and target
for data for this CellRangeSelector.
- See Also:
- setModel
Methods
addTableModelListener
public void addTableModelListener(TableModelListener tableModelListener)
- Add the supplied TableModelListener to the set of listeners to receive
TableModelEvents.
Implements
TableModel.addTableModelListener(TableModelListener)
.
- Parameters:
- tableModelListener - the listener to be added.
getBigDecimal
public BigDecimal[][] getBigDecimal()
- Return the current selection from the source TableModel
as a
java.math.BigDecimal[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the BigDecimal[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a BigDecimal and is not null.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getBigDecimal
- setInvertData
getBigInteger
public BigInteger[][] getBigInteger()
- Return the current selection from the source TableModel
as a
java.math.BigInteger[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the BigInteger[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a BigInteger and is not null.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getBigInteger
- setInvertData
getBoolean
public boolean[][] getBoolean()
- Return the current selection from the source TableModel
as a
boolean[][]
.
By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the boolean[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a boolean.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getBoolean
- setInvertData
getByte
public byte[][] getByte()
- Return the current selection from the source TableModel
as a
byte[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the byte[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a byte.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getByte
- setInvertData
getByteArray
public byte[][][] getByteArray()
- Return the current selection from the source TableModel
as a
byte[][][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data. The byte[][][] can be treated as a two dimensional array
of byte[].
- Returns:
- the byte[][][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a byte[] and is not null.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getByteArray
- setInvertData
getColumnClass
public Class getColumnClass(int columnIndex)
- Return the class of the column addressed by this selector
at the supplied
columnIndex
.
Implements TableModel.getColumnClass()
.
- Returns:
- the class of the column at the supplied column index.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
getColumnCount
public int getColumnCount()
- Return the number of columns addressed by the CellRangeSelector.
Implements
TableModel.getColumnCount()
.
- Returns:
- the number of columns addressed by the CellRangeSelector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- See Also:
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
getColumnName
public String getColumnName(int columnIndex)
- Return the name of the column addressed by this selector.
at the supplied
columnIndex
.
Implements TableModel.getColumnName()
.
- Returns:
- the name of the column at the supplied column index.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
getColumnNames
public String[] getColumnNames()
- Return a String[] containing the names of the columns currently
referenced by this selector.
- Returns:
- a String[] containing the names of the columns currently
referenced by this selector.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- MAXIMUM_COLUMNS
getDate
public Date[][] getDate()
- Return the current selection from the source TableModel
as a
java.sql.Date[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the Date[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a Date and is not null.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getDate
- setInvertData
getDouble
public double[][] getDouble()
- Return the current selection from the source TableModel
as a
double[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the double[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a double.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getDouble
- setInvertData
getFloat
public float[][] getFloat()
- Return the current selection from the source TableModel
as a
float[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the float[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a float.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getFloat
- setInvertData
getIncludeColumnNames
public boolean getIncludeColumnNames()
- Return whether the column names are to be included as
the first elements of column data obtained as String values.
- Returns:
- boolean indicating whether column names are to be included.
- See Also:
- setIncludeColumnNames
getInt
public int[][] getInt()
- Return the current selection from the source TableModel
as an
int[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the int[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to an int.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getInt
- setInvertData
getInvertData
public boolean getInvertData()
- Return whether the data values are to be inverted row against
column during retrieval from, or update to, the source TableModel.
- Returns:
- boolean indicating whether data values are to be inverted.
- See Also:
- setInvertData
getLong
public long[][] getLong()
- Return the current selection from the source TableModel
as a
long[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the long[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a long.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getLong
- setInvertData
getMaximumColumns
public int getMaximumColumns()
- Return the maximum number of columns to be selected, or
Selector.NO_MAXIMUM
if the selection should extend to the
last available column.
- Returns:
- the maximum number of selected columns,
or
Selector.NO_MAXIMUM
.
- See Also:
- setMaximumColumns
- NO_MAXIMUM
getMaximumRows
public int getMaximumRows()
- Return the maximum number of rows to be selected, or
Selector.NO_MAXIMUM
if the selection should extend to the
last available row.
- Returns:
- the maximum number of selected rows,
or
Selector.NO_MAXIMUM
.
- See Also:
- setMaximumRows
- NO_MAXIMUM
getObject
public Object[][] getObject()
- Return the current selection from the source TableModel
as an
Object[][][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the Object[][][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- See Also:
- setInvertData
getRowCount
public int getRowCount()
- Return the number of rows addressed by the CellRangeSelector.
Implements
TableModel.getRowCount()
.
- Returns:
- the number of rows addressed by the CellRangeSelector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- See Also:
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
getShort
public short[][] getShort()
- Return the current selection from the source TableModel
as a
short[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the short[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a short.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getShort
- setInvertData
getStartColumnNumber
public int getStartColumnNumber()
- Return the index number of the first column for the currently selected cells,
adjusted according to the current value of
getIndexFromOne()
.
- Returns:
- the adjusted column index number for the first column of the
currently selected cells.
- See Also:
- setStartColumnNumber
- setIndexFromOne
getStartRowNumber
public int getStartRowNumber()
- Return the index number of the first row for the currently selected cells,
adjusted according to the current value of
getIndexFromOne()
.
- Returns:
- the adjusted row index number for the first row of the
currently selected cells.
- See Also:
- setStartRowNumber
- setMaximumRows
- setIndexFromOne
getString
public String[][] getString()
- Return the current selection from the source TableModel
as a
String[][][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the String[][][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- See Also:
- getString
- setInvertData
getTime
public Time[][] getTime()
- Return the current selection from the source TableModel
as a
java.sql.Time[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the Time[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a Time and is not null.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getTime
- setInvertData
getTimestamp
public Timestamp[][] getTimestamp()
- Return the current selection from the source TableModel
as a
java.sql.Timestamp[][]
. By default the first dimension
of the array will contain a row of data. If data inversion
is in effect then the first dimension will contain a column of
data.
- Returns:
- the Timestamp[][] representation of the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- if any of the values in the current selection cannot be coerced
to a Timestamp and is not null.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- getTimestamp
- setInvertData
getValueAt
public Object getValueAt(int rowIndex,
int columnIndex)
- Return the value at the supplied cell location.
Implements
TableModel.getValueAt()
.
- Returns:
- the object at the cell identified by the supplied
row index and column index.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- START_ROW_NUMBER
- setStartRowNumber
getVectorArray
public Vector[] getVectorArray()
- Return the current selection from the source TableModel
as a
Vector[]
.
By default each vector element
will contain a row of data. If data inversion
is in effect then each vector element will contain a column of
data.
The type of the vector elements
is determined by the current vectorContentType
.
- Returns:
- a Vector[] containing values derived from the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- See Also:
- setVectorContentType
- setInvertData
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
getVectorOfVectors
public Vector getVectorOfVectors()
- Return the current selection from the source TableModel
as a Vector of Vectors.
By default each vector element
will contain a vector containing a row of data. If data inversion
is in effect then each vector element will contain a vector containing
a column of
data.
The type of the vector elements
is determined by the current
vectorContentType
.
- Returns:
- a Vector containing vectors containing values derived from the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- See Also:
- setVectorContentType
- setInvertData
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
isCellEditable
public boolean isCellEditable(int rowIndex,
int columnIndex)
- Return whether the value at the supplied cell location is editable.
Implements
TableModel.isCellEditable()
.
- Returns:
- whether the object at the supplied cell location is editable.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- START_ROW_NUMBER
- setStartRowNumber
removeTableModelListener
public void removeTableModelListener(TableModelListener tableModelListener)
- Remove the supplied TableModelListener from the set of listeners to receive
TableModelEvents.
Implements
TableModel.removeTableModelListener(TableModelListener)
.
- Parameters:
- tableModelListener - the listener to be removed.
setBigDecimal
public void setBigDecimal(BigDecimal[][] values)
- Update the current selection using the supplied
java.math.BigDecimal[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the BigDecimal[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setBigInteger
public void setBigInteger(BigInteger[][] values)
- Update the current selection using the supplied
java.math.BigInteger[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the BigInteger[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setBoolean
public void setBoolean(boolean[][] values)
- Update the current selection using the supplied
boolean[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the boolean[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setByte
public void setByte(byte[][] values)
- Update the current selection using the supplied
byte[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the byte[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setByteArray
public void setByteArray(byte[][][] values)
- Update the current selection using the supplied
byte[][][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
The byte[][][] will be treated as a two dimensional array
of byte[].
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the byte[][][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setDate
public void setDate(Date[][] values)
- Update the current selection using the supplied
java.sql.Date[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the Date[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setDouble
public void setDouble(double[][] values)
- Update the current selection using the supplied
double[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the double[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setFloat
public void setFloat(float[][] values)
- Update the current selection using the supplied
float[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the float[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setIncludeColumnNames
public void setIncludeColumnNames(boolean includeColumnNames)
- Specify whether the column names are to be included as
the first element of column data. This only has effect when
column data are retrieved as String values.
- Parameters:
- includeColumnNames - boolean controlling column name inclusion.
- See Also:
- setNotificationType
setInt
public void setInt(int[][] values)
- Update the current selection using the supplied
int[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the int[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setInvertData
public void setInvertData(boolean invertData)
- Specify whether the data values are to be inverted row against
column during retrieval from, or update to, the source TableModel.
The default orientation is row biased. Two dimensional arrays
will have one first level dimension for each row, and one
second level dimension for each column. When data is
inverted then this arrangement will be reversed.
This affects arrays and vectors retrieved via the various
getXXX
methods, and the treatment of
arrays and vectors delivered to the various
setXXX
methods.
- Parameters:
- invertData - specifying whether data values are to be inverted.
- See Also:
- getInvertData
setLong
public void setLong(long[][] values)
- Update the current selection using the supplied
long[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the long[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setMaximumColumns
public void setMaximumColumns(int maximumColumns)
- Specify the maximum number of columns to be selected.
- Parameters:
- maximumColumns - the maximum number of selected columns,
or
Selector.NO_MAXIMUM
to
indicate that the last column of the selection should be the
last column in the source TableModel.
- See Also:
- setStartColumnNumber
- NO_MAXIMUM
setMaximumRows
public void setMaximumRows(int maximumRows)
- Specify the maximum number of rows to be selected.
- Parameters:
- maximumRows - the maximum number of selected rows,
or
Selector.NO_MAXIMUM
to
indicate that the last row of the selection should be the
last row in the source TableModel.
- See Also:
- setStartRowNumber
- NO_MAXIMUM
setObject
public void setObject(Object[][] values)
- Update the current selection using the supplied
Object[][][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the Object[][][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setShort
public void setShort(short[][] values)
- Update the current selection using the supplied
short[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the short[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setStartColumnNumber
public void setStartColumnNumber(int startColumnNumber)
- Specify the index number of the first column for the currently selected cells.
If
getIndexFromOne()
returns true
, then
startColumnNumber should be specified as 1
to indicate the
first row in the source TableModel.
The value specified for startColumnNumber is not validated until an attempt is
made to retrieve/set data through the selector. If the source TableModel does
not contain the specified column, the startColumnNumber is set to the last
column in the source TableModel and an exception is thrown.
- Parameters:
- startColumnNumber - the column index number for the first column of the
currently selected cells.
- See Also:
- setMaximumColumns
- setIndexFromOne
setStartRowNumber
public void setStartRowNumber(int startRowNumber)
- Specify the index number of the first row for the currently selected cells.
If
getIndexFromOne()
returns true
, then
startRowNumber should be specified as 1
to indicate the
first row in the source TableModel.
After the source TableModel has been set for the selector,
if rows are inserted or deleted into the source TableModel prior to the
startRowNumber, the startRowNumber is automatically adjusted so the
selected data is not changed.
If the source TableModel is reset or the source TableModel triggers an
event that the table has completely changed, then no attempt is made to
modify the startRowNumber and the selected data may change.
The value specified for startRowNumber is not validated until an attempt is
made to retrieve/set data through the selector. If the source TableModel does
not contain the specified row, the startRowNumber is set to the last row
in the source TableModel and an exception is thrown.
- Parameters:
- startRowNumber - the row index number for the first row of the
currently selected cells.
- See Also:
- setMaximumRows
- setIndexFromOne
setString
public void setString(String[][] values)
- Update the current selection using the supplied
String[][][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the String[][][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setTime
public void setTime(Time[][] values)
- Update the current selection using the supplied
java.sql.Time[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the Time[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setTimestamp
public void setTimestamp(Timestamp[][] values)
- Update the current selection using the supplied
java.sql.Timestamp[][]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default the first dimension of the supplied array will be
interpreted as containing a row of data. If data inversion
is in effect then the first dimension will be interpreted as
containing a column of data. If the supplied values cannot be
interpreted as the type of the corresponding current selection cells,
a SelectorException is thrown.
- Parameters:
- values - the Timestamp[][] used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
- setInvertData
setValueAt
public void setValueAt(Object aValue,
int rowIndex,
int columnIndex)
- Set the value at the supplied cell location using the supplied
value.
Implements
TableModel.setValueAt()
.
- Parameters:
- aValue - the value to be used to update the specified cell.
- rowIndex - the row index of the target cell.
- columnIndex - the column index of the target cell.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- START_ROW_NUMBER
- setStartRowNumber
setVectorArray
public void setVectorArray(Vector[] values)
- Update the current selection using the supplied
Vector[]
.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default each vector element
will be assumed to contain a row of data. If data inversion
is in effect then each vector element will be assumed to contain a
column of data.
If the supplied values cannot be interpreted as the type of the
corresponding current selection cells, a SelectorException is thrown.
- Parameters:
- values - the Vector[] containing the values used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
setVectorOfVectors
public void setVectorOfVectors(Vector values)
- Update the current selection using the supplied
Vector of Vectors.
If there are more values supplied than are referenced by this
selector, excess values will be ignored.
By default each vector element
will be assumed to contain a vector containing a row of data.
If data inversion
is in effect then each vector element will be assumed to contain
a vector containing a column of data.
If the supplied values cannot be interpreted as the type of the
corresponding current selection cells, a SelectorException is thrown.
- Parameters:
- values - the Vector containing vectors containing the values used to update the current selection.
- Throws: SelectorException
- NO_MODEL
- when there is no TableModel associated with this selector.
- Throws: SelectorException
- START_COLUMN_NUMBER
- when the current selection start column number is outside of the
range of column numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_COLUMNS
- when the current selection maximum number of columns is invalid.
- Throws: SelectorException
- START_ROW_NUMBER
- when the current selection start row number is outside of the
range of row numbers in the associated TableModel.
- Throws: SelectorException
- MAXIMUM_ROWS
- when the current selection maximum number of rows is invalid.
- Throws: SelectorException
- COERCION
- when the supplied values cannot be coerced to the type required
by the current selection.
- See Also:
- NO_MODEL
- START_COLUMN_NUMBER
- setStartColumnNumber
- MAXIMUM_COLUMNS
- setMaximumColumns
- START_ROW_NUMBER
- setStartRowNumber
- MAXIMUM_ROWS
- setMaximumRows
- COERCION
