Home » openjdk-7 » javax » swing » table » [javadoc | source]
javax.swing.table
public class: DefaultTableColumnModel [javadoc | source]
java.lang.Object
   javax.swing.table.DefaultTableColumnModel

All Implemented Interfaces:
    java$io$Serializable, PropertyChangeListener, ListSelectionListener, TableColumnModel

Direct Known Subclasses:
    ClassColumnModel

The standard column-handler for a JTable.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeansTM has been added to the java.beans package. Please see java.beans.XMLEncoder .

Field Summary
protected  Vector<TableColumn> tableColumns    Array of TableColumn objects in this model 
protected  ListSelectionModel selectionModel    Model for keeping track of column selections 
protected  int columnMargin    Width margin between each column 
protected  EventListenerList listenerList    List of TableColumnModelListener 
protected transient  ChangeEvent changeEvent    Change event (only one needed) 
protected  boolean columnSelectionAllowed    Column selection allowed in this column model 
protected  int totalColumnWidth    A local cache of the combined width of all columns 
Constructor:
 public DefaultTableColumnModel() 
Method from javax.swing.table.DefaultTableColumnModel Summary:
addColumn,   addColumnModelListener,   createSelectionModel,   fireColumnAdded,   fireColumnMarginChanged,   fireColumnMoved,   fireColumnRemoved,   fireColumnSelectionChanged,   getColumn,   getColumnCount,   getColumnIndex,   getColumnIndexAtX,   getColumnMargin,   getColumnModelListeners,   getColumnSelectionAllowed,   getColumns,   getListeners,   getSelectedColumnCount,   getSelectedColumns,   getSelectionModel,   getTotalColumnWidth,   moveColumn,   propertyChange,   recalcWidthCache,   removeColumn,   removeColumnModelListener,   setColumnMargin,   setColumnSelectionAllowed,   setSelectionModel,   valueChanged
Methods from java.lang.Object:
clone,   equals,   finalize,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from javax.swing.table.DefaultTableColumnModel Detail:
 public  void addColumn(TableColumn aColumn) 
    Appends aColumn to the end of the tableColumns array. This method also posts the columnAdded event to its listeners.
 public  void addColumnModelListener(TableColumnModelListener x) 
    Adds a listener for table column model events.
 protected ListSelectionModel createSelectionModel() 
    Creates a new default list selection model.
 protected  void fireColumnAdded(TableColumnModelEvent e) 
    Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the parameters passed into the fire method.
 protected  void fireColumnMarginChanged() 
    Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the parameters passed into the fire method.
 protected  void fireColumnMoved(TableColumnModelEvent e) 
    Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the parameters passed into the fire method.
 protected  void fireColumnRemoved(TableColumnModelEvent e) 
    Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the parameters passed into the fire method.
 protected  void fireColumnSelectionChanged(ListSelectionEvent e) 
    Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the parameters passed into the fire method.
 public TableColumn getColumn(int columnIndex) 
    Returns the TableColumn object for the column at columnIndex.
 public int getColumnCount() 
    Returns the number of columns in the tableColumns array.
 public int getColumnIndex(Object identifier) 
    Returns the index of the first column in the tableColumns array whose identifier is equal to identifier, when compared using equals.
 public int getColumnIndexAtX(int x) 
    Returns the index of the column that lies at position x, or -1 if no column covers this point. 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 accomodate 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 given xPosition should 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.columnAtPoint can be used instead.
 public int getColumnMargin() 
    Returns the width margin for TableColumn. The default columnMargin is 1.
 public TableColumnModelListener[] getColumnModelListeners() 
    Returns an array of all the column model listeners registered on this model.
 public boolean getColumnSelectionAllowed() 
    Returns true if column selection is allowed, otherwise false. The default is false.
 public Enumeration<TableColumn> getColumns() 
    Returns an Enumeration of all the columns in the model.
 public T[] getListeners(Class<T> listenerType) 
    Returns an array of all the objects currently registered as FooListeners upon this model. 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 DefaultTableColumnModel m for its column model listeners with the following code:

    ColumnModelListener[] cmls = (ColumnModelListener[])(m.getListeners(ColumnModelListener.class));
    If no such listeners exist, this method returns an empty array.
 public int getSelectedColumnCount() 
    Returns the number of columns selected.
 public int[] getSelectedColumns() 
    Returns an array of selected columns. If selectionModel is null, returns an empty array.
 public ListSelectionModel getSelectionModel() 
    Returns the ListSelectionModel that is used to maintain column selection state.
 public int getTotalColumnWidth() 
    Returns the total combined width of all columns.
 public  void moveColumn(int columnIndex,
    int newIndex) 
    Moves the column and heading at columnIndex to newIndex. The old column at columnIndex will now be found at newIndex. The column that used to be at newIndex is shifted left or right to make room. This will not move any columns if columnIndex equals newIndex. This method also posts a columnMoved event to its listeners.
 public  void propertyChange(PropertyChangeEvent evt) 
    Property Change Listener change method. Used to track changes to the column width or preferred column width.
 protected  void recalcWidthCache() 
    Recalculates the total combined width of all columns. Updates the totalColumnWidth property.
 public  void removeColumn(TableColumn column) 
    Deletes the column from the tableColumns array. This method will do nothing if column is not in the table's columns list. tile is called to resize both the header and table views. This method also posts a columnRemoved event to its listeners.
 public  void removeColumnModelListener(TableColumnModelListener x) 
    Removes a listener for table column model events.
 public  void setColumnMargin(int newMargin) 
    Sets the column margin to newMargin. This method also posts a columnMarginChanged event to its listeners.
 public  void setColumnSelectionAllowed(boolean flag) 
    Sets whether column selection is allowed. The default is false.
 public  void setSelectionModel(ListSelectionModel newModel) 
    Sets the selection model for this TableColumnModel to newModel and registers for listener notifications from the new selection model. If newModel is null, an exception is thrown.
 public  void valueChanged(ListSelectionEvent e) 
    A ListSelectionListener that forwards ListSelectionEvents when there is a column selection change.