TableColumnModel (Java SE 15 & JDK 15) (original) (raw)

• Method Details

  • addColumn

  Appends aColumn to the end of thetableColumns array. This method posts a columnAdded event to its listeners.
  Parameters:
  aColumn - the TableColumn to be added
  See Also:
  removeColumn(javax.swing.table.TableColumn)

  • removeColumn

  Deletes the TableColumn column from thetableColumns array. This method will do nothing ifcolumn is not in the table's column list. This method posts a columnRemoved event to its listeners.
  Parameters:
  column - the TableColumn to be removed
  See Also:
  addColumn(javax.swing.table.TableColumn)

  • moveColumn

  void moveColumn​(int columnIndex, int newIndex)
  Moves the column and its header at columnIndex tonewIndex. 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 ifcolumnIndex equals newIndex. This method posts a columnMoved event to its listeners.
  Parameters:
  columnIndex - the index of column to be moved
  newIndex - index of the column's new location
  Throws:
  [IllegalArgumentException](../../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if columnIndex ornewIndex are not in the valid range

  • setColumnMargin

  void setColumnMargin​(int newMargin)
  Sets the TableColumn's column margin tonewMargin. This method posts a columnMarginChanged event to its listeners.
  Parameters:
  newMargin - the width, in pixels, of the new column margins
  See Also:
  getColumnMargin()

  • getColumnCount

  int getColumnCount()
  Returns the number of columns in the model.
  Returns:
  the number of columns in the model

  • getColumns

  Returns an Enumeration of all the columns in the model.
  Returns:
  an Enumeration of all the columns in the model

  • getColumnIndex

  int getColumnIndex​(Object columnIdentifier)
  Returns the index of the first column in the table whose identifier is equal to identifier, when compared using equals.
  Parameters:
  columnIdentifier - the identifier object
  Returns:
  the index of the first table column whose identifier is equal to identifier
  Throws:
  [IllegalArgumentException](../../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if identifier is null, or noTableColumn has thisidentifier
  See Also:
  getColumn(int)

  • getColumn

  Returns the TableColumn object for the column atcolumnIndex.
  Parameters:
  columnIndex - the index of the desired column
  Returns:
  the TableColumn object for the column at columnIndex

  • getColumnMargin

  int getColumnMargin()
  Returns the width between the cells in each column.
  Returns:
  the margin, in pixels, between the cells

  • getColumnIndexAtX

  int 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 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.
  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:
  JTable.columnAtPoint(java.awt.Point)

  • getTotalColumnWidth

  int getTotalColumnWidth()
  Returns the total width of all the columns.
  Returns:
  the total computed width of all columns

  • setColumnSelectionAllowed

  void 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:
  getColumnSelectionAllowed()

  • getColumnSelectionAllowed

  boolean getColumnSelectionAllowed()
  Returns true if columns may be selected.
  Returns:
  true if columns may be selected
  See Also:
  setColumnSelectionAllowed(boolean)

  • getSelectedColumns

  int[] getSelectedColumns()
  Returns an array of indicies of all selected columns.
  Returns:
  an array of integers containing the indicies of all selected columns; or an empty array if nothing is selected

  • getSelectedColumnCount

  int getSelectedColumnCount()
  Returns the number of selected columns.
  Returns:
  the number of selected columns; or 0 if no columns are selected

  • setSelectionModel

  Sets the selection model.
  Parameters:
  newModel - a ListSelectionModel object
  See Also:
  getSelectionModel()

  • getSelectionModel

  Returns the current selection model.
  Returns:
  a ListSelectionModel object
  See Also:
  setSelectionModel(javax.swing.ListSelectionModel)

  • addColumnModelListener

  Adds a listener for table column model events.
  Parameters:
  x - a TableColumnModelListener object

  • removeColumnModelListener

  Removes a listener for table column model events.
  Parameters:
  x - a TableColumnModelListener object