- 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
Modifier and TypeClassDescriptionprotected class
The class provides an implementation of the Java Accessibility API appropriate to table cells.protected class
Describes a change in the accessible table model.Nested classes/interfaces declared in class javax.swing.JComponent.AccessibleJComponent
JComponent.AccessibleJComponent.AccessibleContainerHandler, JComponent.AccessibleJComponent.AccessibleFocusHandler
Nested classes/interfaces declared in class java.awt.Component.AccessibleAWTComponent
Component.AccessibleAWTComponent.AccessibleAWTComponentHandler, Component.AccessibleAWTComponent.AccessibleAWTFocusHandler
-
Field Summary
Fields declared in class javax.swing.JComponent.AccessibleJComponent
accessibleFocusHandler
Fields declared in class java.awt.Container.AccessibleAWTContainer
accessibleContainerHandler
Fields declared in class java.awt.Component.AccessibleAWTComponent
accessibleAWTComponentHandler, accessibleAWTFocusHandler
Fields 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
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addAccessibleSelection
(int i) Adds the specifiedAccessible
child of the object to the object's selection.void
Clears the selection in the object, so that no children in the object are selected.void
Track changes to the table contents (column insertions)void
Track changes of a column moving due to margin changes.void
Track changes of a column repositioning.void
Track changes to the table contents (column deletions)void
Track that the selection model of the TableColumnModel changed.void
Invoked when editing is canceled.void
Track changes to a cell's contents.getAccessibleAt
(int r, int c) Returns theAccessible
at a specified row and column in the table.Returns theAccessible
child, if one exists, contained at the local coordinatePoint
.Returns the caption for the table.getAccessibleChild
(int i) Returns the nthAccessible
child of the object.int
Returns the number of accessible children in the object.int
getAccessibleColumn
(int index) Returns the column number of an index in the table.int
getAccessibleColumnAtIndex
(int i) Returns the column at a given index into the table.int
Returns the number of columns in the table.Returns the description of the specified column in the table.int
getAccessibleColumnExtentAt
(int r, int c) Returns the number of columns occupied by theAccessible
at a given (row, column).Returns the column headers as anAccessibleTable
.int
getAccessibleIndex
(int r, int c) Returns the index at a row and column in the table.int
getAccessibleIndexAt
(int r, int c) Returns the index at a given (row, column) in the table.Gets the role of this object.int
getAccessibleRow
(int index) Returns the row number of an index in the table.int
getAccessibleRowAtIndex
(int i) Returns the row at a given index into the table.int
Returns the number of rows in the table.getAccessibleRowDescription
(int r) Returns the description of the specified row in the table.int
getAccessibleRowExtentAt
(int r, int c) Returns the number of rows occupied by theAccessible
at a specified row and column in the table.Returns the row headers as anAccessibleTable
.Get the AccessibleSelection associated with this object.getAccessibleSelection
(int i) Returns anAccessible
representing the specified selected child in the object.int
Returns the number ofAccessible
children currently selected.Returns the summary description of the table.Gets theAccessibleTable
associated with this object.int[]
Returns the selected columns in a table.int[]
Returns the selected rows in a table.boolean
isAccessibleChildSelected
(int i) Determines if the current child of this object is selected.boolean
isAccessibleColumnSelected
(int c) Returns a boolean value indicating whether the specified column is selected.boolean
isAccessibleRowSelected
(int r) Returns a boolean value indicating whether the specified row is selected.boolean
isAccessibleSelected
(int r, int c) Returns a boolean value indicating whether the accessible at a given (row, column) is selected.void
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 mechanismvoid
removeAccessibleSelection
(int i) Removes the specified child of the object from the object's selection.void
Causes every child of the object to be selected, but only if theJTable
supports multiple selections, and if individual cell selection is enabled.void
Sets the caption for the table.void
setAccessibleColumnDescription
(int c, Accessible a) Sets the description text of the specified column of the table.void
Sets the column headers as anAccessibleTable
.void
setAccessibleRowDescription
(int r, Accessible a) Sets the description text of the specified row of the table.void
Sets the row headers as anAccessibleTable
.void
Sets the summary description of the table.void
Track changes to the table contentsvoid
Track changes to the table contents (row deletions)void
Track changes to the table contents (row insertions)void
Track changes to table cell selectionsMethods declared in class javax.swing.JComponent.AccessibleJComponent
addPropertyChangeListener, getAccessibleDescription, getAccessibleKeyBinding, getAccessibleName, getAccessibleStateSet, getBorderTitle, getTitledBorderText, getToolTipText, removePropertyChangeListener
Methods 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, setVisible
Methods declared in class javax.accessibility.AccessibleContext
firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleText, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParent
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods 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, setVisible
-
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:
propertyChange
in 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:
tableChanged
in interfaceTableModelListener
- Parameters:
e
- aTableModelEvent
describing the event
-
tableRowsInserted
Track changes to the table contents (row insertions)- Parameters:
e
- aTableModelEvent
describing the event
-
tableRowsDeleted
Track changes to the table contents (row deletions)- Parameters:
e
- aTableModelEvent
describing the event
-
columnAdded
Track changes to the table contents (column insertions)- Specified by:
columnAdded
in interfaceTableColumnModelListener
- Parameters:
e
- aTableColumnModelEvent
-
columnRemoved
Track changes to the table contents (column deletions)- Specified by:
columnRemoved
in interfaceTableColumnModelListener
- Parameters:
e
- aTableColumnModelEvent
-
columnMoved
Track changes of a column repositioning.- Specified by:
columnMoved
in interfaceTableColumnModelListener
- Parameters:
e
- aTableColumnModelEvent
- See Also:
-
columnMarginChanged
Track changes of a column moving due to margin changes.- Specified by:
columnMarginChanged
in interfaceTableColumnModelListener
- Parameters:
e
- aChangeEvent
- See Also:
-
columnSelectionChanged
Track that the selection model of the TableColumnModel changed.- Specified by:
columnSelectionChanged
in interfaceTableColumnModelListener
- Parameters:
e
- aListSelectionEvent
- See Also:
-
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:
editingStopped
in interfaceCellEditorListener
- Parameters:
e
- theChangeEvent
containing the source of the event- See Also:
-
editingCanceled
Invoked when editing is canceled. The editor object is discarded and the cell is rendered once again.- Specified by:
editingCanceled
in interfaceCellEditorListener
- Parameters:
e
- theChangeEvent
containing the source of the event- See Also:
-
valueChanged
Track changes to table cell selections- Specified by:
valueChanged
in 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:
getAccessibleSelection
in classAccessibleContext
- Returns:
- this object
- See Also:
-
getAccessibleRole
Gets the role of this object.- Overrides:
getAccessibleRole
in classJComponent.AccessibleJComponent
- Returns:
- an instance of AccessibleRole describing the role of the object
- See Also:
-
getAccessibleAt
Returns theAccessible
child, if one exists, contained at the local coordinatePoint
.- Specified by:
getAccessibleAt
in interfaceAccessibleComponent
- Overrides:
getAccessibleAt
in 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:
getAccessibleChildrenCount
in classJComponent.AccessibleJComponent
- Returns:
- the number of accessible children in the object
-
getAccessibleChild
Returns the nthAccessible
child of the object.- Overrides:
getAccessibleChild
in classJComponent.AccessibleJComponent
- Parameters:
i
- zero-based index of child- Returns:
- the nth Accessible child of the object
- See Also:
-
getAccessibleSelectionCount
public int getAccessibleSelectionCount()Returns the number ofAccessible
children currently selected. If no children are selected, the return value will be 0.- Specified by:
getAccessibleSelectionCount
in interfaceAccessibleSelection
- Returns:
- the number of items currently selected
-
getAccessibleSelection
Returns anAccessible
representing 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:
getAccessibleSelection
in interfaceAccessibleSelection
- Parameters:
i
- the zero-based index of selected children- Returns:
- the i-th selected child
- See Also:
-
isAccessibleChildSelected
public boolean isAccessibleChildSelected(int i) Determines if the current child of this object is selected.- Specified by:
isAccessibleChildSelected
in interfaceAccessibleSelection
- Parameters:
i
- the zero-based index of the child in thisAccessible
object- Returns:
- true if the current child of this object is selected
- See Also:
-
addAccessibleSelection
public void addAccessibleSelection(int i) Adds the specifiedAccessible
child 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
JTable
s which have individual cell selection enabled.- Specified by:
addAccessibleSelection
in interfaceAccessibleSelection
- Parameters:
i
- the zero-based index of the child- See Also:
-
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
JTables
which have individual cell selection enabled.- Specified by:
removeAccessibleSelection
in interfaceAccessibleSelection
- Parameters:
i
- the zero-based index of the child- See Also:
-
clearAccessibleSelection
public void clearAccessibleSelection()Clears the selection in the object, so that no children in the object are selected.- Specified by:
clearAccessibleSelection
in interfaceAccessibleSelection
-
selectAllAccessibleSelection
public void selectAllAccessibleSelection()Causes every child of the object to be selected, but only if theJTable
supports multiple selections, and if individual cell selection is enabled.- Specified by:
selectAllAccessibleSelection
in interfaceAccessibleSelection
-
getAccessibleRow
public int getAccessibleRow(int index) Returns the row number of an index in the table.- Specified by:
getAccessibleRow
in 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:
getAccessibleColumn
in 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:
getAccessibleIndex
in 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 theAccessibleTable
associated with this object. In the implementation of the Java Accessibility API for this class, return this object, which is responsible for implementing theAccessibleTables
interface on behalf of itself.- Overrides:
getAccessibleTable
in classAccessibleContext
- Returns:
- this object
- Since:
- 1.3
- See Also:
-
getAccessibleCaption
Returns the caption for the table.- Specified by:
getAccessibleCaption
in interfaceAccessibleTable
- Returns:
- the caption for the table
- Since:
- 1.3
-
setAccessibleCaption
Sets the caption for the table.- Specified by:
setAccessibleCaption
in interfaceAccessibleTable
- Parameters:
a
- the caption for the table- Since:
- 1.3
-
getAccessibleSummary
Returns the summary description of the table.- Specified by:
getAccessibleSummary
in interfaceAccessibleTable
- Returns:
- the summary description of the table
- Since:
- 1.3
-
setAccessibleSummary
Sets the summary description of the table.- Specified by:
setAccessibleSummary
in interfaceAccessibleTable
- Parameters:
a
- the summary description of the table- Since:
- 1.3
-
getAccessibleRowCount
public int getAccessibleRowCount()Description copied from interface:AccessibleTable
Returns the number of rows in the table.- Specified by:
getAccessibleRowCount
in interfaceAccessibleTable
- Returns:
- the number of rows in the table
-
getAccessibleColumnCount
public int getAccessibleColumnCount()Description copied from interface:AccessibleTable
Returns the number of columns in the table.- Specified by:
getAccessibleColumnCount
in interfaceAccessibleTable
- Returns:
- the number of columns in the table
-
getAccessibleAt
Description copied from interface:AccessibleTable
Returns theAccessible
at a specified row and column in the table.- Specified by:
getAccessibleAt
in interfaceAccessibleTable
- Parameters:
r
- zero-based row of the tablec
- zero-based column of the table- Returns:
- the
Accessible
at the specified row and column
-
getAccessibleRowExtentAt
public int getAccessibleRowExtentAt(int r, int c) Returns the number of rows occupied by theAccessible
at a specified row and column in the table.- Specified by:
getAccessibleRowExtentAt
in interfaceAccessibleTable
- Parameters:
r
- zero-based row of the tablec
- zero-based column of the table- Returns:
- the number of rows occupied by the
Accessible
at 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 theAccessible
at a given (row, column).- Specified by:
getAccessibleColumnExtentAt
in interfaceAccessibleTable
- Parameters:
r
- zero-based row of the tablec
- zero-based column of the table- Returns:
- the number of columns occupied by the
Accessible
at a specified row and column in the table - Since:
- 1.3
-
getAccessibleRowHeader
Returns the row headers as anAccessibleTable
.- Specified by:
getAccessibleRowHeader
in interfaceAccessibleTable
- Returns:
- an
AccessibleTable
representing the row headers - Since:
- 1.3
-
setAccessibleRowHeader
Sets the row headers as anAccessibleTable
.- Specified by:
setAccessibleRowHeader
in interfaceAccessibleTable
- Parameters:
a
- anAccessibleTable
representing the row headers- Since:
- 1.3
-
getAccessibleColumnHeader
Returns the column headers as anAccessibleTable
.- Specified by:
getAccessibleColumnHeader
in interfaceAccessibleTable
- Returns:
- an
AccessibleTable
representing the column headers, ornull
if the table header isnull
- Since:
- 1.3
-
setAccessibleColumnHeader
Sets the column headers as anAccessibleTable
.- Specified by:
setAccessibleColumnHeader
in interfaceAccessibleTable
- Parameters:
a
- anAccessibleTable
representing the column headers- Since:
- 1.3
-
getAccessibleRowDescription
Returns the description of the specified row in the table.- Specified by:
getAccessibleRowDescription
in 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:
setAccessibleRowDescription
in 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:
getAccessibleColumnDescription
in 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:
setAccessibleColumnDescription
in 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:
isAccessibleSelected
in 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:
isAccessibleRowSelected
in 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:
isAccessibleColumnSelected
in 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:
getSelectedAccessibleRows
in 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:
getSelectedAccessibleColumns
in 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
-