javax.swing
Class JComponent.AccessibleJComponent

java.lang.Object
  extended by javax.accessibility.AccessibleContext
      extended by java.awt.Component.AccessibleAWTComponent
          extended by java.awt.Container.AccessibleAWTContainer
              extended by javax.swing.JComponent.AccessibleJComponent
All Implemented Interfaces:
Serializable, AccessibleComponent, AccessibleExtendedComponent
Direct Known Subclasses:
AbstractButton.AccessibleAbstractButton, JColorChooser.AccessibleJColorChooser, JComboBox.AccessibleJComboBox, JDesktopPane.AccessibleJDesktopPane, JFileChooser.AccessibleJFileChooser, JInternalFrame.AccessibleJInternalFrame, JInternalFrame.JDesktopIcon.AccessibleJDesktopIcon, JLabel.AccessibleJLabel, JLayeredPane.AccessibleJLayeredPane, JList.AccessibleJList, JMenuBar.AccessibleJMenuBar, JOptionPane.AccessibleJOptionPane, JPanel.AccessibleJPanel, JPopupMenu.AccessibleJPopupMenu, JProgressBar.AccessibleJProgressBar, JRootPane.AccessibleJRootPane, JScrollBar.AccessibleJScrollBar, JScrollPane.AccessibleJScrollPane, JSeparator.AccessibleJSeparator, JSlider.AccessibleJSlider, JSplitPane.AccessibleJSplitPane, JTabbedPane.AccessibleJTabbedPane, JTable.AccessibleJTable, JTableHeader.AccessibleJTableHeader, JTextComponent.AccessibleJTextComponent, JToolBar.AccessibleJToolBar, JToolTip.AccessibleJToolTip, JTree.AccessibleJTree, JViewport.AccessibleJViewport
Enclosing class:
JComponent

public abstract class JComponent.AccessibleJComponent
extends Container.AccessibleAWTContainer
implements AccessibleExtendedComponent

Basic accessibility support for JComponent derived widgets.

See Also:
Serialized Form

Nested Class Summary
protected  class JComponent.AccessibleJComponent.AccessibleContainerHandler
          Receives notification if there are child components are added or removed from the JComponent and fires appropriate PropertyChangeEvents to interested listeners on the AccessibleJComponent.
protected  class JComponent.AccessibleJComponent.AccessibleFocusHandler
          Receives notification if the focus on the JComponent changes and fires appropriate PropertyChangeEvents to listeners registered with the AccessibleJComponent.
 
Nested classes/interfaces inherited from class java.awt.Component.AccessibleAWTComponent
Component.AccessibleAWTComponent.AccessibleAWTComponentHandler, Component.AccessibleAWTComponent.AccessibleAWTFocusHandler
 
Field Summary
protected  ContainerListener accessibleContainerHandler
          Receives notification when a child component is added to the JComponent and fires a PropertyChangeEvent on listeners registered with the AccessibleJComponent.
protected  FocusListener accessibleFocusHandler
          Receives notification if the focus on the JComponent changes and fires appropriate PropertyChangeEvents to listeners registered with the AccessibleJComponent.
 
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_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
protected JComponent.AccessibleJComponent()
          Creates a new AccessibleJComponent.
 
Method Summary
 void addPropertyChangeListener(PropertyChangeListener listener)
          Adds a property change listener to the list of registered listeners.
 Accessible getAccessibleChild(int i)
          Returns the accessible child component at index i.
 int getAccessibleChildrenCount()
          Returns the number of accessible children of this object.
 String getAccessibleDescription()
          Returns the localized description of this object.
 AccessibleKeyBinding getAccessibleKeyBinding()
          Returns the keybindings associated with this accessible component or null if the component does not support key bindings.
 String getAccessibleName()
          Returns the localized name for this object.
 AccessibleRole getAccessibleRole()
          Returns the accessible role of this component.
 AccessibleStateSet getAccessibleStateSet()
          Returns the accessible state set of this component.
protected  String getBorderTitle(Border border)
          Recursivly searches a border hierarchy (starting at border) for a titled border and returns the title if one is found, null otherwise.
 String getTitledBorderText()
          Returns the title of the border of this accessible component if this component has a titled border, otherwise returns null.
 String getToolTipText()
          Returns the tooltip text for this accessible component.
 void removePropertyChangeListener(PropertyChangeListener listener)
          Removes a property change listener from the list of registered listeners.
 
Methods inherited from class java.awt.Container.AccessibleAWTContainer
getAccessibleAt
 
Methods inherited from 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 inherited from class javax.accessibility.AccessibleContext
firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleSelection, 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, getAccessibleAt, 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

accessibleContainerHandler

protected ContainerListener accessibleContainerHandler
Receives notification when a child component is added to the JComponent and fires a PropertyChangeEvent on listeners registered with the AccessibleJComponent.


accessibleFocusHandler

protected FocusListener accessibleFocusHandler
Receives notification if the focus on the JComponent changes and fires appropriate PropertyChangeEvents to listeners registered with the AccessibleJComponent.

Constructor Detail

JComponent.AccessibleJComponent

protected JComponent.AccessibleJComponent()
Creates a new AccessibleJComponent.

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
Adds a property change listener to the list of registered listeners. This sets up the accessibleContainerHandler and accessibleFocusHandler fields and calls super.addPropertyChangeListener(listener).

Overrides:
addPropertyChangeListener in class Component.AccessibleAWTComponent
Parameters:
listener - the listener to add
See Also:
AccessibleContext.ACCESSIBLE_NAME_PROPERTY, AccessibleContext.ACCESSIBLE_DESCRIPTION_PROPERTY, AccessibleContext.ACCESSIBLE_STATE_PROPERTY, AccessibleContext.ACCESSIBLE_VALUE_PROPERTY, AccessibleContext.ACCESSIBLE_SELECTION_PROPERTY, AccessibleContext.ACCESSIBLE_TEXT_PROPERTY, AccessibleContext.ACCESSIBLE_VISIBLE_DATA_PROPERTY

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
Removes a property change listener from the list of registered listeners. This uninstalls the accessibleContainerHandler and accessibleFocusHandler fields and calls super.removePropertyChangeListener(listener).

Overrides:
removePropertyChangeListener in class Component.AccessibleAWTComponent
Parameters:
listener - the listener to remove
See Also:
AccessibleContext.addPropertyChangeListener(PropertyChangeListener)

getAccessibleChildrenCount

public int getAccessibleChildrenCount()
Returns the number of accessible children of this object.

Overrides:
getAccessibleChildrenCount in class Container.AccessibleAWTContainer
Returns:
the number of accessible children of this object
See Also:
AccessibleContext.getAccessibleChild(int)

getAccessibleChild

public Accessible getAccessibleChild(int i)
Returns the accessible child component at index i.

Overrides:
getAccessibleChild in class Container.AccessibleAWTContainer
Parameters:
i - the index of the accessible child to return
Returns:
the accessible child component at index i
See Also:
Component.AccessibleAWTComponent.getAccessibleChildrenCount()

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()
Returns the accessible state set of this component.

Overrides:
getAccessibleStateSet in class Component.AccessibleAWTComponent
Returns:
the accessible state set of this component
See Also:
AccessibleState

getAccessibleName

public String getAccessibleName()
Returns the localized name for this object. Generally this should almost never return Component.getName() since that is not a localized name. If the object is some kind of text component (like a menu item), then the value of the object may be returned. Also, if the object has a tooltip, the value of the tooltip may also be appropriate.

Overrides:
getAccessibleName in class Component.AccessibleAWTComponent
Returns:
the localized name for this object or null if this object has no name
See Also:
AccessibleContext.setAccessibleName(String)

getAccessibleDescription

public String getAccessibleDescription()
Returns the localized description of this object.

Overrides:
getAccessibleDescription in class Component.AccessibleAWTComponent
Returns:
the localized description of this object or null if this object has no description
See Also:
AccessibleContext.setAccessibleDescription(String)

getAccessibleRole

public AccessibleRole getAccessibleRole()
Returns the accessible role of this component.

Overrides:
getAccessibleRole in class Component.AccessibleAWTComponent
Returns:
the accessible role of this component
See Also:
AccessibleRole

getBorderTitle

protected String getBorderTitle(Border border)
Recursivly searches a border hierarchy (starting at border) for a titled border and returns the title if one is found, null otherwise.

Parameters:
border - the border to start search from
Returns:
the border title of a possibly found titled border

getToolTipText

public String getToolTipText()
Returns the tooltip text for this accessible component.

Specified by:
getToolTipText in interface AccessibleExtendedComponent
Returns:
the tooltip text for this accessible component

getTitledBorderText

public String getTitledBorderText()
Returns the title of the border of this accessible component if this component has a titled border, otherwise returns null.

Specified by:
getTitledBorderText in interface AccessibleExtendedComponent
Returns:
the title of the border of this accessible component if this component has a titled border, otherwise returns null

getAccessibleKeyBinding

public AccessibleKeyBinding getAccessibleKeyBinding()
Returns the keybindings associated with this accessible component or null if the component does not support key bindings.

Specified by:
getAccessibleKeyBinding in interface AccessibleExtendedComponent
Returns:
the keybindings associated with this accessible component