javax.swing
Class JTree.AccessibleJTree

java.lang.Object
  javax.accessibility.AccessibleContext
      java.awt.Component.AccessibleAWTComponent
          java.awt.Container.AccessibleAWTContainer
              javax.swing.JComponent.AccessibleJComponent
                  javax.swing.JTree.AccessibleJTree

All Implemented Interfaces:

javax.accessibility.AccessibleComponent, javax.accessibility.AccessibleExtendedComponent, javax.accessibility.AccessibleSelection, EventListener, Serializable, TreeExpansionListener, TreeModelListener, TreeSelectionListener

Enclosing class:

JTree

protected class JTree.AccessibleJTree

extends JComponent.AccessibleJComponent

implements javax.accessibility.AccessibleSelection, TreeSelectionListener, TreeModelListener, TreeExpansionListener

This class implements accessibility support for the JTree class. It provides an implementation of the Java Accessibility API appropriate to tree 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^TM has been added to the java.beans package. Please see XMLEncoder.

See Also:

Serialized Form

Nested Class Summary

protected class

JTree.AccessibleJTree.AccessibleJTreeNode This class implements accessibility support for the JTree child.

Nested classes inherited from class javax.swing.JComponent.AccessibleJComponent

JComponent.AccessibleJComponent.AccessibleContainerHandler, JComponent.AccessibleJComponent.AccessibleFocusHandler

Nested classes inherited from class java.awt.Component.AccessibleAWTComponent

Component.AccessibleAWTComponent.AccessibleAWTComponentHandler, Component.AccessibleAWTComponent.AccessibleAWTFocusHandler

Field Summary

(package private) javax.accessibility.Accessible	leadSelectionAccessible
(package private) TreePath	leadSelectionPath

Fields inherited from class javax.swing.JComponent.AccessibleJComponent

accessibleContainerHandler, accessibleFocusHandler

Fields inherited from class java.awt.Component.AccessibleAWTComponent

accessibleAWTComponentHandler, accessibleAWTFocusHandler

Fields inherited from class javax.accessibility.AccessibleContext

ACCESSIBLE_ACTION_PROPERTY, ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY, ACCESSIBLE_CARET_PROPERTY, ACCESSIBLE_CHILD_PROPERTY, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_HYPERTEXT_OFFSET, 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_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY, accessibleDescription, accessibleName, accessibleParent

Constructor Summary

JTree.AccessibleJTree()

Method Summary

void	addAccessibleSelection(int i) Adds the specified selected item in the object to the object's selection.
void	clearAccessibleSelection() Clears the selection in the object, so that nothing in the object is selected.
void	fireVisibleDataPropertyChange() Fire a visible data property change notification.
javax.accessibility.Accessible	getAccessibleAt(Point p) Returns the Accessible child, if one exists, contained at the local coordinate Point.
javax.accessibility.Accessible	getAccessibleChild(int i) Return the nth Accessible child of the object.
int	getAccessibleChildrenCount() Returns the number of top-level children nodes of this JTree.
int	getAccessibleIndexInParent() Get the index of this object in its accessible parent.
javax.accessibility.AccessibleRole	getAccessibleRole() Get the role of this object.
javax.accessibility.AccessibleSelection	getAccessibleSelection() Get the AccessibleSelection associated with this object.
javax.accessibility.Accessible	getAccessibleSelection(int i) Returns an Accessible representing the specified selected item in the object.
int	getAccessibleSelectionCount() Returns the number of items currently selected.
private javax.accessibility.AccessibleContext	getCurrentAccessibleContext()
private Component	getCurrentComponent()
boolean	isAccessibleChildSelected(int i) Returns true if the current child of this object is selected.
void	removeAccessibleSelection(int i) Removes the specified selected item in the object from the object's selection.
void	selectAllAccessibleSelection() Causes every selected item in the object to be selected if the object supports multiple selections.
void	treeCollapsed(TreeExpansionEvent e) Tree Collapsed notification.
void	treeExpanded(TreeExpansionEvent e) Tree Model Expansion notification.
void	treeNodesChanged(TreeModelEvent e) Tree Model Node change notification.
void	treeNodesInserted(TreeModelEvent e) Tree Model Node change notification.
void	treeNodesRemoved(TreeModelEvent e) Tree Model Node change notification.
void	treeStructureChanged(TreeModelEvent e) Tree Model structure change change notification.
void	valueChanged(TreeSelectionEvent e) Tree Selection Listener value change method.

Methods inherited from class javax.swing.JComponent.AccessibleJComponent

addPropertyChangeListener, getAccessibleDescription, getAccessibleExtendedComponent, getAccessibleKeyBinding, getAccessibleName, getAccessibleStateSet, getBorderTitle, getTitledBorderText, getToolTipText, removePropertyChangeListener

Methods inherited from class java.awt.Component.AccessibleAWTComponent

addFocusListener, contains, getAccessibleComponent, 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 inherited from class javax.accessibility.AccessibleContext

firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleTable, getAccessibleText, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParent

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from 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

Field Detail

leadSelectionPath

TreePath leadSelectionPath

leadSelectionAccessible

javax.accessibility.Accessible leadSelectionAccessible

Constructor Detail

JTree.AccessibleJTree

public JTree.AccessibleJTree()

Method Detail

valueChanged

public void valueChanged(TreeSelectionEvent e)

Tree Selection Listener value change method. Used to fire the property change

Specified by:

valueChanged in interface TreeSelectionListener

Parameters:

e - ListSelectionEvent

fireVisibleDataPropertyChange

public void fireVisibleDataPropertyChange()

Fire a visible data property change notification. A 'visible' data property is one that represents something about the way the component appears on the display, where that appearance isn't bound to any other property. It notifies screen readers that the visual appearance of the component has changed, so they can notify the user.

treeNodesChanged

public void treeNodesChanged(TreeModelEvent e)

Tree Model Node change notification.

Specified by:

treeNodesChanged in interface TreeModelListener

Parameters:

e - a Tree Model event

treeNodesInserted

public void treeNodesInserted(TreeModelEvent e)

Tree Model Node change notification.

Specified by:

treeNodesInserted in interface TreeModelListener

Parameters:

e - a Tree node insertion event

treeNodesRemoved

public void treeNodesRemoved(TreeModelEvent e)

Tree Model Node change notification.

Specified by:

treeNodesRemoved in interface TreeModelListener

Parameters:

e - a Tree node(s) removal event

treeStructureChanged

public void treeStructureChanged(TreeModelEvent e)

Tree Model structure change change notification.

Specified by:

treeStructureChanged in interface TreeModelListener

Parameters:

e - a Tree Model event

treeCollapsed

public void treeCollapsed(TreeExpansionEvent e)

Tree Collapsed notification.

Specified by:

treeCollapsed in interface TreeExpansionListener

Parameters:

e - a TreeExpansionEvent

treeExpanded

public void treeExpanded(TreeExpansionEvent e)

Tree Model Expansion notification.

Specified by:

treeExpanded in interface TreeExpansionListener

Parameters:

e - a Tree node insertion event

getCurrentAccessibleContext

private javax.accessibility.AccessibleContext getCurrentAccessibleContext()

getCurrentComponent

private Component getCurrentComponent()

getAccessibleRole

public javax.accessibility.AccessibleRole getAccessibleRole()

Get the role of this object.

Overrides:

getAccessibleRole in class JComponent.AccessibleJComponent

Returns:

an instance of AccessibleRole describing the role of the object

See Also:

AccessibleRole

getAccessibleAt

public javax.accessibility.Accessible getAccessibleAt(Point p)

Returns the Accessible child, if one exists, contained at the local coordinate Point. Otherwise returns null.

Specified by:

getAccessibleAt in interface javax.accessibility.AccessibleComponent

Overrides:

getAccessibleAt in class Container.AccessibleAWTContainer

Parameters:

p - point in local coordinates of this Accessible

Returns:

the Accessible, if it exists, at the specified location; else null

getAccessibleChildrenCount

public int getAccessibleChildrenCount()

Returns the number of top-level children nodes of this JTree. Each of these nodes may in turn have children nodes.

Overrides:

getAccessibleChildrenCount in class JComponent.AccessibleJComponent

Returns:

the number of accessible children nodes in the tree.

getAccessibleChild

public javax.accessibility.Accessible getAccessibleChild(int i)

Return the nth Accessible child of the object.

Overrides:

getAccessibleChild in class JComponent.AccessibleJComponent

Parameters:

i - zero-based index of child

Returns:

the nth Accessible child of the object

getAccessibleIndexInParent

public int getAccessibleIndexInParent()

Get the index of this object in its accessible parent.

Overrides:

getAccessibleIndexInParent in class Component.AccessibleAWTComponent

Returns:

the index of this object in its parent. Since a JTree top-level object does not have an accessible parent.

See Also:

Component.AccessibleAWTComponent.getAccessibleParent()

getAccessibleSelection

public javax.accessibility.AccessibleSelection 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.

Returns:

this object

getAccessibleSelectionCount

public int getAccessibleSelectionCount()

Returns the number of items currently selected. If no items are selected, the return value will be 0.

Specified by:

getAccessibleSelectionCount in interface javax.accessibility.AccessibleSelection

Returns:

the number of items currently selected.

getAccessibleSelection

public javax.accessibility.Accessible getAccessibleSelection(int i)

Returns an Accessible representing the specified selected item in the object. If there isn't a selection, or there are fewer items selected than the integer passed in, the return value will be null.

Specified by:

getAccessibleSelection in interface javax.accessibility.AccessibleSelection

Parameters:

i - the zero-based index of selected items

Returns:

an Accessible containing the selected item

isAccessibleChildSelected

public boolean isAccessibleChildSelected(int i)

Returns true if the current child of this object is selected.

Specified by:

isAccessibleChildSelected in interface javax.accessibility.AccessibleSelection

Parameters:

i - the zero-based index of the child in this Accessible object.

See Also:

AccessibleContext.getAccessibleChild(int)

addAccessibleSelection

public void addAccessibleSelection(int i)

Adds the specified selected item in the object to the object's selection. If the object supports multiple selections, the specified item is added to any existing selection, otherwise it replaces any existing selection in the object. If the specified item is already selected, this method has no effect.

Specified by:

addAccessibleSelection in interface javax.accessibility.AccessibleSelection

Parameters:

i - the zero-based index of selectable items

removeAccessibleSelection

public void removeAccessibleSelection(int i)

Removes the specified selected item in the object from the object's selection. If the specified item isn't currently selected, this method has no effect.

Specified by:

removeAccessibleSelection in interface javax.accessibility.AccessibleSelection

Parameters:

i - the zero-based index of selectable items

clearAccessibleSelection

public void clearAccessibleSelection()

Clears the selection in the object, so that nothing in the object is selected.

Specified by:

clearAccessibleSelection in interface javax.accessibility.AccessibleSelection

selectAllAccessibleSelection

public void selectAllAccessibleSelection()

Causes every selected item in the object to be selected if the object supports multiple selections.

Specified by:

selectAllAccessibleSelection in interface javax.accessibility.AccessibleSelection