- All Known Implementing Classes:
- DefaultTableColumnModel
public interface TableColumnModel
Defines the requirements for a table column model object suitable for
 use with 
JTable.- See Also:
- 
Method SummaryModifier and TypeMethodDescriptionvoidaddColumn(TableColumn aColumn) AppendsaColumnto the end of thetableColumnsarray.voidAdds a listener for table column model events.getColumn(int columnIndex) Returns theTableColumnobject for the column atcolumnIndex.intReturns the number of columns in the model.intgetColumnIndex(Object columnIdentifier) Returns the index of the first column in the table whose identifier is equal toidentifier, when compared usingequals.intgetColumnIndexAtX(int xPosition) Returns the index of the column that lies on the horizontal point,xPosition; or -1 if it lies outside the any of the column's bounds.intReturns the width between the cells in each column.Returns anEnumerationof all the columns in the model.booleanReturns true if columns may be selected.intReturns the number of selected columns.int[]Returns an array of indices of all selected columns.Returns the current selection model.intReturns the total width of all the columns.voidmoveColumn(int columnIndex, int newIndex) Moves the column and its header atcolumnIndextonewIndex.voidremoveColumn(TableColumn column) Deletes theTableColumncolumnfrom thetableColumnsarray.voidRemoves a listener for table column model events.voidsetColumnMargin(int newMargin) Sets theTableColumn's column margin tonewMargin.voidsetColumnSelectionAllowed(boolean flag) Sets whether the columns in this model may be selected.voidsetSelectionModel(ListSelectionModel newModel) Sets the selection model.
- 
Method Details- 
addColumnAppendsaColumnto the end of thetableColumnsarray. This method posts acolumnAddedevent to its listeners.- Parameters:
- aColumn- the- TableColumnto be added
- See Also:
 
- 
removeColumnDeletes theTableColumncolumnfrom thetableColumnsarray. This method will do nothing ifcolumnis not in the table's column list. This method posts acolumnRemovedevent to its listeners.- Parameters:
- column- the- TableColumnto be removed
- See Also:
 
- 
moveColumnvoid moveColumn(int columnIndex, int newIndex) Moves the column and its header atcolumnIndextonewIndex. The old column atcolumnIndexwill now be found atnewIndex. The column that used to be atnewIndexis shifted left or right to make room. This will not move any columns ifcolumnIndexequalsnewIndex. This method posts acolumnMovedevent to its listeners.- Parameters:
- columnIndex- the index of column to be moved
- newIndex- index of the column's new location
- Throws:
- IllegalArgumentException- if- columnIndexor- newIndexare not in the valid range
 
- 
setColumnMarginvoid setColumnMargin(int newMargin) Sets theTableColumn's column margin tonewMargin. This method posts acolumnMarginChangedevent to its listeners.- Parameters:
- newMargin- the width, in pixels, of the new column margins
- See Also:
 
- 
getColumnCountint getColumnCount()Returns the number of columns in the model.- Returns:
- the number of columns in the model
 
- 
getColumnsEnumeration<TableColumn> getColumns()Returns anEnumerationof all the columns in the model.- Returns:
- an Enumerationof all the columns in the model
 
- 
getColumnIndexReturns the index of the first column in the table whose identifier is equal toidentifier, when compared usingequals.- Parameters:
- columnIdentifier- the identifier object
- Returns:
- the index of the first table column
                  whose identifier is equal to identifier
- Throws:
- IllegalArgumentException- if- identifieris- null, or no- TableColumnhas this- identifier
- See Also:
 
- 
getColumnReturns theTableColumnobject for the column atcolumnIndex.- Parameters:
- columnIndex- the index of the desired column
- Returns:
- the TableColumnobject for the column atcolumnIndex
 
- 
getColumnMarginint getColumnMargin()Returns the width between the cells in each column.- Returns:
- the margin, in pixels, between the cells
 
- 
getColumnIndexAtXint getColumnIndexAtX(int xPosition) Returns the index of the column that lies on the horizontal point,xPosition; or -1 if it lies outside the any of the column's bounds. In keeping with Swing's separable model architecture, a TableColumnModel does not know how the table columns actually appear on screen. The visual presentation of the columns is the responsibility of the view/controller object using this model (typically JTable). The view/controller need not display the columns sequentially from left to right. For example, columns could be displayed from right to left to accommodate a locale preference or some columns might be hidden at the request of the user. Because the model does not know how the columns are laid out on screen, the givenxPositionshould not be considered to be a coordinate in 2D graphics space. Instead, it should be considered to be a width from the start of the first column in the model. If the column index for a given X coordinate in 2D space is required,JTable.columnAtPointcan be used instead.- Parameters:
- xPosition- width from the start of the first column in the model.
- Returns:
- the index of the column; or -1 if no column is found
- See Also:
 
- 
getTotalColumnWidthint getTotalColumnWidth()Returns the total width of all the columns.- Returns:
- the total computed width of all columns
 
- 
setColumnSelectionAllowedvoid setColumnSelectionAllowed(boolean flag) Sets whether the columns in this model may be selected.- Parameters:
- flag- true if columns may be selected; otherwise false
- See Also:
 
- 
getColumnSelectionAllowedboolean getColumnSelectionAllowed()Returns true if columns may be selected.- Returns:
- true if columns may be selected
- See Also:
 
- 
getSelectedColumnsint[] getSelectedColumns()Returns an array of indices of all selected columns.- Returns:
- an array of integers containing the indices of all selected columns; or an empty array if nothing is selected
 
- 
getSelectedColumnCountint getSelectedColumnCount()Returns the number of selected columns.- Returns:
- the number of selected columns; or 0 if no columns are selected
 
- 
setSelectionModelSets the selection model.- Parameters:
- newModel- a- ListSelectionModelobject
- See Also:
 
- 
getSelectionModelListSelectionModel getSelectionModel()Returns the current selection model.- Returns:
- a ListSelectionModelobject
- See Also:
 
- 
addColumnModelListenerAdds a listener for table column model events.- Parameters:
- x- a- TableColumnModelListenerobject
 
- 
removeColumnModelListenerRemoves a listener for table column model events.- Parameters:
- x- a- TableColumnModelListenerobject
 
 
-