- All Implemented Interfaces:
PropertyChangeListener,Serializable,EventListener,AccessibleComponent,AccessibleExtendedComponent,AccessibleExtendedTable,AccessibleSelection,AccessibleTable,CellEditorListener,ListSelectionListener,TableColumnModelListener,TableModelListener
- Enclosing class:
- JTable
protected class JTable.AccessibleJTable extends JComponent.AccessibleJComponent implements AccessibleSelection, ListSelectionListener, TableModelListener, TableColumnModelListener, CellEditorListener, PropertyChangeListener, AccessibleExtendedTable
This class implements accessibility support for the
JTable class. It provides an implementation of the
Java Accessibility API appropriate to table user-interface elements.
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 JavaBeans™
has been added to the java.beans package.
Please see XMLEncoder.
-
Nested Class Summary
Nested Classes Modifier and Type Class Description protected classJTable.AccessibleJTable.AccessibleJTableCellThe class provides an implementation of the Java Accessibility API appropriate to table cells.protected classJTable.AccessibleJTable.AccessibleJTableModelChangeDescribes a change in the accessible table model.Nested classes/interfaces declared in class javax.swing.JComponent.AccessibleJComponent
JComponent.AccessibleJComponent.AccessibleContainerHandler, JComponent.AccessibleJComponent.AccessibleFocusHandlerNested classes/interfaces declared in class java.awt.Component.AccessibleAWTComponent
Component.AccessibleAWTComponent.AccessibleAWTComponentHandler, Component.AccessibleAWTComponent.AccessibleAWTFocusHandler -
Field Summary
Fields declared in class java.awt.Component.AccessibleAWTComponent
accessibleAWTComponentHandler, accessibleAWTFocusHandlerFields declared in class javax.accessibility.AccessibleContext
ACCESSIBLE_ACTION_PROPERTY, ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY, ACCESSIBLE_CARET_PROPERTY, ACCESSIBLE_CHILD_PROPERTY, ACCESSIBLE_COMPONENT_BOUNDS_CHANGED, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_HYPERTEXT_OFFSET, ACCESSIBLE_INVALIDATE_CHILDREN, ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_TABLE_CAPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED, ACCESSIBLE_TABLE_MODEL_CHANGED, ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_ROW_HEADER_CHANGED, ACCESSIBLE_TABLE_SUMMARY_CHANGED, ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY, accessibleDescription, accessibleName, accessibleParent -
Constructor Summary
Constructors Modifier Constructor Description protectedAccessibleJTable()AccessibleJTable constructor -
Method Summary
Modifier and Type Method Description voidaddAccessibleSelection(int i)Adds the specifiedAccessiblechild of the object to the object's selection.voidclearAccessibleSelection()Clears the selection in the object, so that no children in the object are selected.voidcolumnAdded(TableColumnModelEvent e)Track changes to the table contents (column insertions)voidcolumnMarginChanged(ChangeEvent e)Track changes of a column moving due to margin changes.voidcolumnMoved(TableColumnModelEvent e)Track changes of a column repositioning.voidcolumnRemoved(TableColumnModelEvent e)Track changes to the table contents (column deletions)voidcolumnSelectionChanged(ListSelectionEvent e)Track that the selection model of the TableColumnModel changed.voideditingCanceled(ChangeEvent e)Invoked when editing is canceled.voideditingStopped(ChangeEvent e)Track changes to a cell's contents.AccessiblegetAccessibleAt(Point p)Returns theAccessiblechild, if one exists, contained at the local coordinatePoint.AccessiblegetAccessibleCaption()Returns the caption for the table.AccessiblegetAccessibleChild(int i)Returns the nthAccessiblechild of the object.intgetAccessibleChildrenCount()Returns the number of accessible children in the object.intgetAccessibleColumn(int index)Returns the column number of an index in the table.intgetAccessibleColumnAtIndex(int i)Returns the column at a given index into the table.AccessiblegetAccessibleColumnDescription(int c)Returns the description of the specified column in the table.intgetAccessibleColumnExtentAt(int r, int c)Returns the number of columns occupied by theAccessibleat a given (row, column).AccessibleTablegetAccessibleColumnHeader()Returns the column headers as anAccessibleTable.intgetAccessibleIndex(int r, int c)Returns the index at a row and column in the table.intgetAccessibleIndexAt(int r, int c)Returns the index at a given (row, column) in the table.AccessibleRolegetAccessibleRole()Gets the role of this object.intgetAccessibleRow(int index)Returns the row number of an index in the table.intgetAccessibleRowAtIndex(int i)Returns the row at a given index into the table.AccessiblegetAccessibleRowDescription(int r)Returns the description of the specified row in the table.intgetAccessibleRowExtentAt(int r, int c)Returns the number of rows occupied by theAccessibleat a specified row and column in the table.AccessibleTablegetAccessibleRowHeader()Returns the row headers as anAccessibleTable.AccessibleSelectiongetAccessibleSelection()Get the AccessibleSelection associated with this object.AccessiblegetAccessibleSelection(int i)Returns anAccessiblerepresenting the specified selected child in the object.intgetAccessibleSelectionCount()Returns the number ofAccessiblechildren currently selected.AccessiblegetAccessibleSummary()Returns the summary description of the table.AccessibleTablegetAccessibleTable()Gets theAccessibleTableassociated with this object.int[]getSelectedAccessibleColumns()Returns the selected columns in a table.int[]getSelectedAccessibleRows()Returns the selected rows in a table.booleanisAccessibleChildSelected(int i)Determines if the current child of this object is selected.booleanisAccessibleColumnSelected(int c)Returns a boolean value indicating whether the specified column is selected.booleanisAccessibleRowSelected(int r)Returns a boolean value indicating whether the specified row is selected.booleanisAccessibleSelected(int r, int c)Returns a boolean value indicating whether the accessible at a given (row, column) is selected.voidpropertyChange(PropertyChangeEvent e)Track changes to selection model, column model, etc. so as to be able to re-place listeners on those in order to pass on information to the Accessibility PropertyChange mechanismvoidremoveAccessibleSelection(int i)Removes the specified child of the object from the object's selection.voidselectAllAccessibleSelection()Causes every child of the object to be selected, but only if theJTablesupports multiple selections, and if individual cell selection is enabled.voidsetAccessibleCaption(Accessible a)Sets the caption for the table.voidsetAccessibleColumnDescription(int c, Accessible a)Sets the description text of the specified column of the table.voidsetAccessibleColumnHeader(AccessibleTable a)Sets the column headers as anAccessibleTable.voidsetAccessibleRowDescription(int r, Accessible a)Sets the description text of the specified row of the table.voidsetAccessibleRowHeader(AccessibleTable a)Sets the row headers as anAccessibleTable.voidsetAccessibleSummary(Accessible a)Sets the summary description of the table.voidtableChanged(TableModelEvent e)Track changes to the table contentsvoidtableRowsDeleted(TableModelEvent e)Track changes to the table contents (row deletions)voidtableRowsInserted(TableModelEvent e)Track changes to the table contents (row insertions)voidvalueChanged(ListSelectionEvent e)Track changes to table cell selectionsMethods declared in class javax.swing.JComponent.AccessibleJComponent
addPropertyChangeListener, getAccessibleDescription, getAccessibleKeyBinding, getAccessibleName, getAccessibleStateSet, getBorderTitle, getTitledBorderText, getToolTipText, removePropertyChangeListenerMethods declared in class java.awt.Component.AccessibleAWTComponent
addFocusListener, contains, getAccessibleComponent, getAccessibleIndexInParent, getAccessibleParent, getBackground, getBounds, getCursor, getFont, getFontMetrics, getForeground, getLocale, getLocation, getLocationOnScreen, getSize, isEnabled, isFocusTraversable, isShowing, isVisible, removeFocusListener, requestFocus, setBackground, setBounds, setCursor, setEnabled, setFont, setForeground, setLocation, setSize, setVisibleMethods declared in class javax.accessibility.AccessibleContext
firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleText, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParentMethods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods declared in interface javax.accessibility.AccessibleComponent
addFocusListener, contains, getBackground, getBounds, getCursor, getFont, getFontMetrics, getForeground, getLocation, getLocationOnScreen, getSize, isEnabled, isFocusTraversable, isShowing, isVisible, removeFocusListener, requestFocus, setBackground, setBounds, setCursor, setEnabled, setFont, setForeground, setLocation, setSize, setVisibleMethods declared in interface javax.accessibility.AccessibleTable
getAccessibleAt, getAccessibleColumnCount, getAccessibleRowCount
-
Constructor Details
-
AccessibleJTable
protected AccessibleJTable()AccessibleJTable constructor- Since:
- 1.5
-
-
Method Details
-
propertyChange
Track changes to selection model, column model, etc. so as to be able to re-place listeners on those in order to pass on information to the Accessibility PropertyChange mechanism- Specified by:
propertyChangein interfacePropertyChangeListener- Parameters:
e- A PropertyChangeEvent object describing the event source and the property that has changed.
-
tableChanged
Track changes to the table contents- Specified by:
tableChangedin interfaceTableModelListener- Parameters:
e- aTableModelEventdescribing the event
-
tableRowsInserted
Track changes to the table contents (row insertions)- Parameters:
e- aTableModelEventdescribing the event
-
tableRowsDeleted
Track changes to the table contents (row deletions)- Parameters:
e- aTableModelEventdescribing the event
-
columnAdded
Track changes to the table contents (column insertions)- Specified by:
columnAddedin interfaceTableColumnModelListener- Parameters:
e- aTableColumnModelEvent
-
columnRemoved
Track changes to the table contents (column deletions)- Specified by:
columnRemovedin interfaceTableColumnModelListener- Parameters:
e- aTableColumnModelEvent
-
columnMoved
Track changes of a column repositioning.- Specified by:
columnMovedin interfaceTableColumnModelListener- Parameters:
e- aTableColumnModelEvent- See Also:
TableColumnModelListener
-
columnMarginChanged
Track changes of a column moving due to margin changes.- Specified by:
columnMarginChangedin interfaceTableColumnModelListener- Parameters:
e- aChangeEvent- See Also:
TableColumnModelListener
-
columnSelectionChanged
Track that the selection model of the TableColumnModel changed.- Specified by:
columnSelectionChangedin interfaceTableColumnModelListener- Parameters:
e- aListSelectionEvent- See Also:
TableColumnModelListener
-
editingStopped
Track changes to a cell's contents. Invoked when editing is finished. The changes are saved, the editor object is discarded, and the cell is rendered once again.- Specified by:
editingStoppedin interfaceCellEditorListener- Parameters:
e- theChangeEventcontaining the source of the event- See Also:
CellEditorListener
-
editingCanceled
Invoked when editing is canceled. The editor object is discarded and the cell is rendered once again.- Specified by:
editingCanceledin interfaceCellEditorListener- Parameters:
e- theChangeEventcontaining the source of the event- See Also:
CellEditorListener
-
valueChanged
Track changes to table cell selections- Specified by:
valueChangedin interfaceListSelectionListener- Parameters:
e- the event that characterizes the change.
-
getAccessibleSelection
Get the AccessibleSelection associated with this object. In the implementation of the Java Accessibility API for this class, return this object, which is responsible for implementing the AccessibleSelection interface on behalf of itself.- Overrides:
getAccessibleSelectionin classAccessibleContext- Returns:
- this object
- See Also:
AccessibleSelection
-
getAccessibleRole
Gets the role of this object.- Overrides:
getAccessibleRolein classJComponent.AccessibleJComponent- Returns:
- an instance of AccessibleRole describing the role of the object
- See Also:
AccessibleRole
-
getAccessibleAt
Returns theAccessiblechild, if one exists, contained at the local coordinatePoint.- Specified by:
getAccessibleAtin interfaceAccessibleComponent- Overrides:
getAccessibleAtin classContainer.AccessibleAWTContainer- Parameters:
p- the point defining the top-left corner of theAccessible, given in the coordinate space of the object's parent- Returns:
- the
Accessible, if it exists, at the specified location; elsenull
-
getAccessibleChildrenCount
public int getAccessibleChildrenCount()Returns the number of accessible children in the object. If all of the children of this object implementAccessible, then this method should return the number of children of this object.- Overrides:
getAccessibleChildrenCountin classJComponent.AccessibleJComponent- Returns:
- the number of accessible children in the object
-
getAccessibleChild
Returns the nthAccessiblechild of the object.- Overrides:
getAccessibleChildin classJComponent.AccessibleJComponent- Parameters:
i- zero-based index of child- Returns:
- the nth Accessible child of the object
- See Also:
AccessibleContext.getAccessibleChildrenCount()
-
getAccessibleSelectionCount
public int getAccessibleSelectionCount()Returns the number ofAccessiblechildren currently selected. If no children are selected, the return value will be 0.- Specified by:
getAccessibleSelectionCountin interfaceAccessibleSelection- Returns:
- the number of items currently selected
-
getAccessibleSelection
Returns anAccessiblerepresenting the specified selected child in the object. If there isn't a selection, or there are fewer children selected than the integer passed in, the return value will benull.Note that the index represents the i-th selected child, which is different from the i-th child.
- Specified by:
getAccessibleSelectionin interfaceAccessibleSelection- Parameters:
i- the zero-based index of selected children- Returns:
- the i-th selected child
- See Also:
getAccessibleSelectionCount()
-
isAccessibleChildSelected
public boolean isAccessibleChildSelected(int i)Determines if the current child of this object is selected.- Specified by:
isAccessibleChildSelectedin interfaceAccessibleSelection- Parameters:
i- the zero-based index of the child in thisAccessibleobject- Returns:
- true if the current child of this object is selected
- See Also:
AccessibleContext.getAccessibleChild(int)
-
addAccessibleSelection
public void addAccessibleSelection(int i)Adds the specifiedAccessiblechild of the object to the object's selection. If the object supports multiple selections, the specified child is added to any existing selection, otherwise it replaces any existing selection in the object. If the specified child is already selected, this method has no effect.This method only works on
JTables which have individual cell selection enabled.- Specified by:
addAccessibleSelectionin interfaceAccessibleSelection- Parameters:
i- the zero-based index of the child- See Also:
AccessibleContext.getAccessibleChild(int)
-
removeAccessibleSelection
public void removeAccessibleSelection(int i)Removes the specified child of the object from the object's selection. If the specified item isn't currently selected, this method has no effect.This method only works on
JTableswhich have individual cell selection enabled.- Specified by:
removeAccessibleSelectionin interfaceAccessibleSelection- Parameters:
i- the zero-based index of the child- See Also:
AccessibleContext.getAccessibleChild(int)
-
clearAccessibleSelection
public void clearAccessibleSelection()Clears the selection in the object, so that no children in the object are selected.- Specified by:
clearAccessibleSelectionin interfaceAccessibleSelection
-
selectAllAccessibleSelection
public void selectAllAccessibleSelection()Causes every child of the object to be selected, but only if theJTablesupports multiple selections, and if individual cell selection is enabled.- Specified by:
selectAllAccessibleSelectionin interfaceAccessibleSelection
-
getAccessibleRow
public int getAccessibleRow(int index)Returns the row number of an index in the table.- Specified by:
getAccessibleRowin interfaceAccessibleExtendedTable- Parameters:
index- the zero-based index in the table- Returns:
- the zero-based row of the table if one exists; otherwise -1.
- Since:
- 1.4
-
getAccessibleColumn
public int getAccessibleColumn(int index)Returns the column number of an index in the table.- Specified by:
getAccessibleColumnin interfaceAccessibleExtendedTable- Parameters:
index- the zero-based index in the table- Returns:
- the zero-based column of the table if one exists; otherwise -1.
- Since:
- 1.4
-
getAccessibleIndex
public int getAccessibleIndex(int r, int c)Returns the index at a row and column in the table.- Specified by:
getAccessibleIndexin interfaceAccessibleExtendedTable- Parameters:
r- zero-based row of the tablec- zero-based column of the table- Returns:
- the zero-based index in the table if one exists; otherwise -1.
- Since:
- 1.4
-
getAccessibleTable
Gets theAccessibleTableassociated with this object. In the implementation of the Java Accessibility API for this class, return this object, which is responsible for implementing theAccessibleTablesinterface on behalf of itself.- Overrides:
getAccessibleTablein classAccessibleContext- Returns:
- this object
- Since:
- 1.3
- See Also:
AccessibleTable
-
getAccessibleCaption
Returns the caption for the table.- Specified by:
getAccessibleCaptionin interfaceAccessibleTable- Returns:
- the caption for the table
- Since:
- 1.3
-
setAccessibleCaption
Sets the caption for the table.- Specified by:
setAccessibleCaptionin interfaceAccessibleTable- Parameters:
a- the caption for the table- Since:
- 1.3
-
getAccessibleSummary
Returns the summary description of the table.- Specified by:
getAccessibleSummaryin interfaceAccessibleTable- Returns:
- the summary description of the table
- Since:
- 1.3
-
setAccessibleSummary
Sets the summary description of the table.- Specified by:
setAccessibleSummaryin interfaceAccessibleTable- Parameters:
a- the summary description of the table- Since:
- 1.3
-
getAccessibleRowExtentAt
public int getAccessibleRowExtentAt(int r, int c)Returns the number of rows occupied by theAccessibleat a specified row and column in the table.- Specified by:
getAccessibleRowExtentAtin interfaceAccessibleTable- Parameters:
r- zero-based row of the tablec- zero-based column of the table- Returns:
- the number of rows occupied by the
Accessibleat a specified row and column in the table - Since:
- 1.3
-
getAccessibleColumnExtentAt
public int getAccessibleColumnExtentAt(int r, int c)Returns the number of columns occupied by theAccessibleat a given (row, column).- Specified by:
getAccessibleColumnExtentAtin interfaceAccessibleTable- Parameters:
r- zero-based row of the tablec- zero-based column of the table- Returns:
- the number of columns occupied by the
Accessibleat a specified row and column in the table - Since:
- 1.3
-
getAccessibleRowHeader
Returns the row headers as anAccessibleTable.- Specified by:
getAccessibleRowHeaderin interfaceAccessibleTable- Returns:
- an
AccessibleTablerepresenting the row headers - Since:
- 1.3
-
setAccessibleRowHeader
Sets the row headers as anAccessibleTable.- Specified by:
setAccessibleRowHeaderin interfaceAccessibleTable- Parameters:
a- anAccessibleTablerepresenting the row headers- Since:
- 1.3
-
getAccessibleColumnHeader
Returns the column headers as anAccessibleTable.- Specified by:
getAccessibleColumnHeaderin interfaceAccessibleTable- Returns:
- an
AccessibleTablerepresenting the column headers, ornullif the table header isnull - Since:
- 1.3
-
setAccessibleColumnHeader
Sets the column headers as anAccessibleTable.- Specified by:
setAccessibleColumnHeaderin interfaceAccessibleTable- Parameters:
a- anAccessibleTablerepresenting the column headers- Since:
- 1.3
-
getAccessibleRowDescription
Returns the description of the specified row in the table.- Specified by:
getAccessibleRowDescriptionin interfaceAccessibleTable- Parameters:
r- zero-based row of the table- Returns:
- the description of the row
- Since:
- 1.3
-
setAccessibleRowDescription
Sets the description text of the specified row of the table.- Specified by:
setAccessibleRowDescriptionin interfaceAccessibleTable- Parameters:
r- zero-based row of the tablea- the description of the row- Since:
- 1.3
-
getAccessibleColumnDescription
Returns the description of the specified column in the table.- Specified by:
getAccessibleColumnDescriptionin interfaceAccessibleTable- Parameters:
c- zero-based column of the table- Returns:
- the description of the column
- Since:
- 1.3
-
setAccessibleColumnDescription
Sets the description text of the specified column of the table.- Specified by:
setAccessibleColumnDescriptionin interfaceAccessibleTable- Parameters:
c- zero-based column of the tablea- the description of the column- Since:
- 1.3
-
isAccessibleSelected
public boolean isAccessibleSelected(int r, int c)Returns a boolean value indicating whether the accessible at a given (row, column) is selected.- Specified by:
isAccessibleSelectedin interfaceAccessibleTable- Parameters:
r- zero-based row of the tablec- zero-based column of the table- Returns:
- the boolean value true if the accessible at (row, column) is selected; otherwise, the boolean value false
- Since:
- 1.3
-
isAccessibleRowSelected
public boolean isAccessibleRowSelected(int r)Returns a boolean value indicating whether the specified row is selected.- Specified by:
isAccessibleRowSelectedin interfaceAccessibleTable- Parameters:
r- zero-based row of the table- Returns:
- the boolean value true if the specified row is selected; otherwise, false
- Since:
- 1.3
-
isAccessibleColumnSelected
public boolean isAccessibleColumnSelected(int c)Returns a boolean value indicating whether the specified column is selected.- Specified by:
isAccessibleColumnSelectedin interfaceAccessibleTable- Parameters:
c- zero-based column of the table- Returns:
- the boolean value true if the specified column is selected; otherwise, false
- Since:
- 1.3
-
getSelectedAccessibleRows
public int[] getSelectedAccessibleRows()Returns the selected rows in a table.- Specified by:
getSelectedAccessibleRowsin interfaceAccessibleTable- Returns:
- an array of selected rows where each element is a zero-based row of the table
- Since:
- 1.3
-
getSelectedAccessibleColumns
public int[] getSelectedAccessibleColumns()Returns the selected columns in a table.- Specified by:
getSelectedAccessibleColumnsin interfaceAccessibleTable- Returns:
- an array of selected columns where each element is a zero-based column of the table
- Since:
- 1.3
-
getAccessibleRowAtIndex
public int getAccessibleRowAtIndex(int i)Returns the row at a given index into the table.- Parameters:
i- zero-based index into the table- Returns:
- the row at a given index
- Since:
- 1.3
-
getAccessibleColumnAtIndex
public int getAccessibleColumnAtIndex(int i)Returns the column at a given index into the table.- Parameters:
i- zero-based index into the table- Returns:
- the column at a given index
- Since:
- 1.3
-
getAccessibleIndexAt
public int getAccessibleIndexAt(int r, int c)Returns the index at a given (row, column) in the table.- Parameters:
r- zero-based row of the tablec- zero-based column of the table- Returns:
- the index into the table
- Since:
- 1.3
-