javax.swing

Class JList.AccessibleJList

Enclosing Class:
JList
Implemented Interfaces:
AccessibleComponent, AccessibleExtendedComponent, AccessibleSelection, EventListener, ListDataListener, ListSelectionListener, PropertyChangeListener, Serializable

protected class JList.AccessibleJList
extends JComponent.AccessibleJComponent
implements AccessibleSelection, PropertyChangeListener, ListSelectionListener, ListDataListener

Provides accessibility support for JList.

See Also:
Serialized Form

Nested Class Summary

protected class
JList.AccessibleJList.AccessibleJListChild
Provides accessibility support for list elements in JLists.

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

JComponent.AccessibleJComponent.AccessibleContainerHandler, JComponent.AccessibleJComponent.AccessibleFocusHandler

Nested classes/interfaces inherited from class java.awt.Container.AccessibleAWTContainer

Container.AccessibleAWTContainer.AccessibleContainerHandler

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

Component.AccessibleAWTComponent.AccessibleAWTComponentHandler, Component.AccessibleAWTComponent.AccessibleAWTFocusHandler

Field Summary

Fields inherited from class javax.swing.JComponent.AccessibleJComponent

accessibleContainerHandler, accessibleFocusHandler

Fields inherited from class java.awt.Container.AccessibleAWTContainer

accessibleContainerHandler

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

AccessibleJList()
Create a new AccessibleJList.

Method Summary

void
addAccessibleSelection(int i)
Adds the accessible item with the specified index to the selected items.
void
clearAccessibleSelection()
Remove all selection items from the selection.
void
contentsChanged(ListDataEvent event)
Receives notification when items have changed in the JList.
Accessible
getAccessibleAt(Point p)
Returns the accessible child at the visual location p (relative to the upper left corner of the JList).
Accessible
getAccessibleChild(int n)
Returns the n-th accessible child of this JList.
int
getAccessibleChildrenCount()
Returns the number of accessible children in the JList.
AccessibleRole
getAccessibleRole()
Returns the accessible role for JList, AccessibleRole.LIST.
Accessible
getAccessibleSelection(int n)
Returns the n-th selected accessible child.
int
getAccessibleSelectionCount()
Returns the number of selected accessible children.
AccessibleStateSet
getAccessibleStateSet()
Return the state set of the JList.
void
intervalAdded(ListDataEvent event)
Receives notification when items are inserted into the JList.
void
intervalRemoved(ListDataEvent event)
Receives notification when items are removed from the JList.
boolean
isAccessibleChildSelected(int n)
Returns true if the n-th child is selected, false otherwise.
void
propertyChange(PropertyChangeEvent e)
Receives notification about changes of the JList's properties.
void
removeAccessibleSelection(int i)
Removes the accessible item with the specified index to the selection.
void
selectAllAccessibleSelection()
Selects all items if multiple selections are supported.
void
valueChanged(ListSelectionEvent event)
Receices notification when the list selection is changed.

Methods inherited from class javax.swing.JComponent.AccessibleJComponent

addPropertyChangeListener, getAccessibleChild, getAccessibleChildrenCount, getAccessibleDescription, getAccessibleKeyBinding, getAccessibleName, getAccessibleRole, getAccessibleStateSet, getBorderTitle, getTitledBorderText, getToolTipText, removePropertyChangeListener

Methods inherited from class java.awt.Container.AccessibleAWTContainer

getAccessibleAt, getAccessibleChild, getAccessibleChildrenCount

Methods inherited from class java.awt.Component.AccessibleAWTComponent

addFocusListener, addPropertyChangeListener, contains, getAccessibleAt, getAccessibleChild, getAccessibleChildrenCount, getAccessibleComponent, getAccessibleDescription, getAccessibleIndexInParent, getAccessibleName, getAccessibleParent, getAccessibleRole, getAccessibleStateSet, getBackground, getBounds, getCursor, getFont, getFontMetrics, getForeground, getLocale, getLocation, getLocationOnScreen, getSize, isEnabled, isFocusTraversable, isShowing, isVisible, removeFocusListener, removePropertyChangeListener, requestFocus, setBackground, setBounds, setCursor, setEnabled, setFont, setForeground, setLocation, setSize, setVisible

Methods inherited from class javax.accessibility.AccessibleContext

addPropertyChangeListener, firePropertyChange, getAccessibleAction, getAccessibleChild, getAccessibleChildrenCount, getAccessibleComponent, getAccessibleDescription, getAccessibleEditableText, getAccessibleIcon, getAccessibleIndexInParent, getAccessibleName, getAccessibleParent, getAccessibleRelationSet, getAccessibleRole, getAccessibleSelection, getAccessibleStateSet, getAccessibleTable, getAccessibleText, getAccessibleValue, getLocale, removePropertyChangeListener, setAccessibleDescription, setAccessibleName, setAccessibleParent

Methods inherited from class java.lang.Object

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

Constructor Details

AccessibleJList

public AccessibleJList()
Create a new AccessibleJList.

Method Details

addAccessibleSelection

public void addAccessibleSelection(int i)
Adds the accessible item with the specified index to the selected items. If multiple selections are supported, the item is added to the selection, otherwise the item replaces the current selection.
Specified by:
addAccessibleSelection in interface AccessibleSelection

Parameters:
i - the index of the item to add to the selection


clearAccessibleSelection

public void clearAccessibleSelection()
Remove all selection items from the selection.
Specified by:
clearAccessibleSelection in interface AccessibleSelection


contentsChanged

public void contentsChanged(ListDataEvent event)
Receives notification when items have changed in the JList. This method fires a property change event with AccessibleContext.ACCESSIBLE_VISIBLE_DATA_PROPERTY.
Specified by:
contentsChanged in interface ListDataListener

Parameters:
event - the list data event


getAccessibleAt

public Accessible getAccessibleAt(Point p)
Returns the accessible child at the visual location p (relative to the upper left corner of the JList). If there is no child at that location, this returns null.
Specified by:
getAccessibleAt in interface AccessibleComponent
Overrides:
getAccessibleAt in interface Container.AccessibleAWTContainer

Parameters:
p - the screen location for which to return the accessible child

Returns:
the accessible child at the specified location, or null if there is no child at that location


getAccessibleChild

public Accessible getAccessibleChild(int n)
Returns the n-th accessible child of this JList. This will be an instance of JList.AccessibleJList.AccessibleJListChild. If there is no child at that index, null is returned.
Overrides:
getAccessibleChild in interface JComponent.AccessibleJComponent

Parameters:
n - the index of the child to return

Returns:
the n-th accessible child of this JList


getAccessibleChildrenCount

public int getAccessibleChildrenCount()
Returns the number of accessible children in the JList.
Overrides:
getAccessibleChildrenCount in interface JComponent.AccessibleJComponent

Returns:
the number of accessible children in the JList


getAccessibleRole

public AccessibleRole getAccessibleRole()
Returns the accessible role for JList, AccessibleRole.LIST.
Overrides:
getAccessibleRole in interface JComponent.AccessibleJComponent

Returns:
the accessible role for JList


getAccessibleSelection

public Accessible getAccessibleSelection(int n)
Returns the n-th selected accessible child.
Specified by:
getAccessibleSelection in interface AccessibleSelection

Parameters:
n - the index of the selected child to return

Returns:
the n-th selected accessible child


getAccessibleSelectionCount

public int getAccessibleSelectionCount()
Returns the number of selected accessible children.
Specified by:
getAccessibleSelectionCount in interface AccessibleSelection

Returns:
the number of selected accessible children


getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()
Return the state set of the JList.
Overrides:
getAccessibleStateSet in interface JComponent.AccessibleJComponent

Returns:
the state set of the JList


intervalAdded

public void intervalAdded(ListDataEvent event)
Receives notification when items are inserted into the JList. This method fires a property change event with AccessibleContext.ACCESSIBLE_VISIBLE_DATA_PROPERTY.
Specified by:
intervalAdded in interface ListDataListener

Parameters:
event - the list data event


intervalRemoved

public void intervalRemoved(ListDataEvent event)
Receives notification when items are removed from the JList. This method fires a property change event with AccessibleContext.ACCESSIBLE_VISIBLE_DATA_PROPERTY.
Specified by:
intervalRemoved in interface ListDataListener

Parameters:
event - the list data event


isAccessibleChildSelected

public boolean isAccessibleChildSelected(int n)
Returns true if the n-th child is selected, false otherwise.
Specified by:
isAccessibleChildSelected in interface AccessibleSelection

Parameters:
n - the index of the child of which the selected state is queried

Returns:
true if the n-th child is selected, false otherwise


propertyChange

public void propertyChange(PropertyChangeEvent e)
Receives notification about changes of the JList's properties. This is used to re-register this object as listener to the data model and selection model when the data model or selection model changes.
Specified by:
propertyChange in interface PropertyChangeListener

Parameters:
e - the property change event


removeAccessibleSelection

public void removeAccessibleSelection(int i)
Removes the accessible item with the specified index to the selection.
Specified by:
removeAccessibleSelection in interface AccessibleSelection

Parameters:
i - the index of the item to be removed from the selection


selectAllAccessibleSelection

public void selectAllAccessibleSelection()
Selects all items if multiple selections are supported. Otherwise do nothing.
Specified by:
selectAllAccessibleSelection in interface AccessibleSelection


valueChanged

public void valueChanged(ListSelectionEvent event)
Receices notification when the list selection is changed. This method fires two property change events, the first with AccessibleContext.ACCESSIBLE_VISIBLE_DATA_PROPERTY and the second with AccessibleContext.ACCESSIBLE_SELECTION_PROPERTY.
Specified by:
valueChanged in interface ListSelectionListener

Parameters:
event - the list selection event


JList.java -- Copyright (C) 2002, 2003, 2004, 2005 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.