2362N/A * Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 2362N/A * published by the Free Software Foundation. Oracle designates this 0N/A * particular file as subject to the "Classpath" exception as provided 2362N/A * by Oracle in the LICENSE file that accompanied this code. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2362N/A * or visit www.oracle.com if you need additional information or have any 0N/A * AccessibleContext represents the minimum information all accessible objects 0N/A * return. This information includes the accessible name, description, role, 0N/A * and state of the object, as well as information about its parent and 0N/A * children. AccessibleContext also contains methods for 0N/A * obtaining more specific accessibility information about a component. 0N/A * If the component supports them, these methods will return an object that 0N/A * implements one or more of the following interfaces: 0N/A * <li>{@link AccessibleAction} - the object can perform one or more actions. 0N/A * This interface provides the standard mechanism for an assistive 0N/A * technology to determine what those actions are and tell the object 0N/A * to perform them. Any object that can be manipulated should 0N/A * support this interface. 0N/A * <li>{@link AccessibleComponent} - the object has a graphical representation. 0N/A * This interface provides the standard mechanism for an assistive 0N/A * technology to determine and set the graphical representation of the 0N/A * object. Any object that is rendered on the screen should support 0N/A * <li>{@link AccessibleSelection} - the object allows its children to be 0N/A * selected. This interface provides the standard mechanism for an 0N/A * assistive technology to determine the currently selected children of the object 0N/A * as well as modify its selection set. Any object that has children 0N/A * that can be selected should support this interface. 0N/A * <li>{@link AccessibleText} - the object presents editable textual information 0N/A * on the display. This interface provides the standard mechanism for 0N/A * an assistive technology to access that text via its content, attributes, 0N/A * and spatial location. Any object that contains editable text should 0N/A * support this interface. 0N/A * <li>{@link AccessibleValue} - the object supports a numerical value. This 0N/A * interface provides the standard mechanism for an assistive technology 0N/A * to determine and set the current value of the object, as well as obtain its 0N/A * minimum and maximum values. Any object that supports a numerical value 0N/A * should support this interface.</ul> 0N/A * attribute: isContainer false 0N/A * description: Minimal information that all accessible objects return 0N/A * @author Peter Korn 0N/A * @author Hans Muller 0N/A * @author Willie Walker 0N/A * @author Lynn Monsanto 0N/A * Constant used to determine when the accessibleName property has 0N/A * changed. The old value in the PropertyChangeEvent will be the old 0N/A * accessibleName and the new value will be the new accessibleName. 0N/A * @see #getAccessibleName 0N/A * @see #addPropertyChangeListener 0N/A * Constant used to determine when the accessibleDescription property has 0N/A * changed. The old value in the PropertyChangeEvent will be the 0N/A * old accessibleDescription and the new value will be the new 0N/A * accessibleDescription. 0N/A * @see #getAccessibleDescription 0N/A * @see #addPropertyChangeListener 0N/A * Constant used to determine when the accessibleStateSet property has 0N/A * changed. The old value will be the old AccessibleState and the new 0N/A * value will be the new AccessibleState in the accessibleStateSet. 0N/A * For example, if a component that supports the vertical and horizontal 0N/A * states changes its orientation from vertical to horizontal, the old 0N/A * value will be AccessibleState.VERTICAL and the new value will be 0N/A * AccessibleState.HORIZONTAL. Please note that either value can also 0N/A * be null. For example, when a component changes from being enabled 0N/A * to disabled, the old value will be AccessibleState.ENABLED 0N/A * and the new value will be null. 0N/A * @see #getAccessibleStateSet 0N/A * @see AccessibleState 0N/A * @see AccessibleStateSet 0N/A * @see #addPropertyChangeListener 0N/A * Constant used to determine when the accessibleValue property has 0N/A * changed. The old value in the PropertyChangeEvent will be a Number 0N/A * representing the old value and the new value will be a Number 0N/A * representing the new value 0N/A * @see #getAccessibleValue 0N/A * @see #addPropertyChangeListener 0N/A * Constant used to determine when the accessibleSelection has changed. 0N/A * The old and new values in the PropertyChangeEvent are currently 0N/A * reserved for future use. 0N/A * @see #getAccessibleSelection 0N/A * @see #addPropertyChangeListener 0N/A * Constant used to determine when the accessibleText caret has changed. 0N/A * The old value in the PropertyChangeEvent will be an 0N/A * integer representing the old caret position, and the new value will 0N/A * @see #addPropertyChangeListener 0N/A * Constant used to determine when the visual appearance of the object 0N/A * has changed. The old and new values in the PropertyChangeEvent are 0N/A * currently reserved for future use. 0N/A * @see #addPropertyChangeListener 0N/A * from the object. If an Accessible child is being added, the old 0N/A * value will be null and the new value will be the Accessible child. If an 0N/A * Accessible child is being removed, the old value will be the Accessible 0N/A * child, and the new value will be null. 0N/A * @see #addPropertyChangeListener 0N/A * Constant used to determine when the active descendant of a component 0N/A * has changed. The active descendant is used for objects such as 0N/A * list, tree, and table, which may have transient children. When the 0N/A * active descendant has changed, the old value of the property change 0N/A * event will be the Accessible representing the previous active child, and 0N/A * the new value will be the Accessible representing the current active 0N/A * @see #addPropertyChangeListener 0N/A * Constant used to indicate that the table caption has changed 0N/A * The old value in the PropertyChangeEvent will be an Accessible 0N/A * representing the previous table caption and the new value will 0N/A * be an Accessible representing the new table caption. 0N/A * @see AccessibleTable 0N/A "accessibleTableCaptionChanged";
0N/A * Constant used to indicate that the table summary has changed 0N/A * The old value in the PropertyChangeEvent will be an Accessible 0N/A * representing the previous table summary and the new value will 0N/A * be an Accessible representing the new table summary. 0N/A * @see AccessibleTable 0N/A "accessibleTableSummaryChanged";
0N/A * Constant used to indicate that table data has changed. 0N/A * The old value in the PropertyChangeEvent will be null and the 0N/A * new value will be an AccessibleTableModelChange representing 0N/A * @see AccessibleTable 0N/A * @see AccessibleTableModelChange 0N/A "accessibleTableModelChanged";
0N/A * Constant used to indicate that the row header has changed 0N/A * The old value in the PropertyChangeEvent will be null and the 0N/A * new value will be an AccessibleTableModelChange representing 0N/A * the header change. 0N/A * @see AccessibleTable 0N/A * @see AccessibleTableModelChange 0N/A "accessibleTableRowHeaderChanged";
0N/A * Constant used to indicate that the row description has changed 0N/A * The old value in the PropertyChangeEvent will be null and the 0N/A * new value will be an Integer representing the row index. 0N/A * @see AccessibleTable 0N/A "accessibleTableRowDescriptionChanged";
0N/A * Constant used to indicate that the column header has changed 0N/A * The old value in the PropertyChangeEvent will be null and the 0N/A * new value will be an AccessibleTableModelChange representing 0N/A * the header change. 0N/A * @see AccessibleTable 0N/A * @see AccessibleTableModelChange 0N/A "accessibleTableColumnHeaderChanged";
0N/A * Constant used to indicate that the column description has changed 0N/A * The old value in the PropertyChangeEvent will be null and the 0N/A * new value will be an Integer representing the column index. 0N/A * @see AccessibleTable 0N/A "accessibleTableColumnDescriptionChanged";
0N/A * Constant used to indicate that the supported set of actions 0N/A * has changed. The old value in the PropertyChangeEvent will 0N/A * be an Integer representing the old number of actions supported 0N/A * and the new value will be an Integer representing the new 0N/A * number of actions supported. 0N/A * @see AccessibleAction 0N/A "accessibleActionProperty";
0N/A * Constant used to indicate that a hypertext element has received focus. 0N/A * The old value in the PropertyChangeEvent will be an Integer 0N/A * representing the start index in the document of the previous element 0N/A * that had focus and the new value will be an Integer representing 0N/A * the start index in the document of the current element that has 0N/A * focus. A value of -1 indicates that an element does not or did 0N/A * @see AccessibleHyperlink 0N/A "AccessibleHypertextOffset";
0N/A * PropertyChangeEvent which indicates that text has changed. 0N/A * For text insertion, the oldValue is null and the newValue 0N/A * is an AccessibleTextSequence specifying the text that was 0N/A * For text deletion, the oldValue is an AccessibleTextSequence 0N/A * specifying the text that was deleted and the newValue is null. 0N/A * For text replacement, the oldValue is an AccessibleTextSequence 0N/A * specifying the old text and the newValue is an AccessibleTextSequence 0N/A * specifying the new text. 0N/A * @see #getAccessibleText 0N/A * @see #addPropertyChangeListener 2014N/A * @see AccessibleTextSequence 0N/A * PropertyChangeEvent which indicates that a significant change 0N/A * has occurred to the children of a component like a tree or text. 0N/A * This change notifies the event listener that it needs to 0N/A * reacquire the state of the subcomponents. The oldValue is 0N/A * null and the newValue is the component whose children have 0N/A * @see #getAccessibleText 0N/A * @see #addPropertyChangeListener 2014N/A * @see AccessibleTextSequence 0N/A "accessibleInvalidateChildren";
0N/A * PropertyChangeEvent which indicates that text attributes have changed. 0N/A * For attribute insertion, the oldValue is null and the newValue 0N/A * is an AccessibleAttributeSequence specifying the attributes that were 0N/A * For attribute deletion, the oldValue is an AccessibleAttributeSequence 0N/A * specifying the attributes that were deleted and the newValue is null. 0N/A * For attribute replacement, the oldValue is an AccessibleAttributeSequence 0N/A * specifying the old attributes and the newValue is an 0N/A * AccessibleAttributeSequence specifying the new attributes. 0N/A * @see #getAccessibleText 0N/A * @see #addPropertyChangeListener 2014N/A * @see AccessibleAttributeSequence 0N/A "accessibleTextAttributesChanged";
0N/A * PropertyChangeEvent which indicates that a change has occurred 0N/A * in a component's bounds. 0N/A * The oldValue is the old component bounds and the newValue is 0N/A * the new component bounds. 0N/A * @see #addPropertyChangeListener 0N/A "accessibleComponentBoundsChanged";
0N/A * The accessible parent of this object. 0N/A * @see #getAccessibleParent 0N/A * @see #setAccessibleParent 0N/A * A localized String containing the name of the object. 0N/A * @see #getAccessibleName 0N/A * @see #setAccessibleName 0N/A * A localized String containing the description of the object. 0N/A * @see #getAccessibleDescription 0N/A * @see #setAccessibleDescription 0N/A * Used to handle the listener list for property change events. 0N/A * @see #addPropertyChangeListener 0N/A * @see #removePropertyChangeListener 0N/A * @see #firePropertyChangeListener 0N/A * Used to represent the context's relation set 0N/A * @see #getAccessibleRelationSet 0N/A * Gets the accessibleName property of this object. The accessibleName 0N/A * property of an object is a localized String that designates the purpose 0N/A * of the object. For example, the accessibleName property of a label 0N/A * or button might be the text of the label or button itself. In the 0N/A * case of an object that doesn't display its name, the accessibleName 0N/A * should still be set. For example, in the case of a text field used 0N/A * to enter the name of a city, the accessibleName for the en_US locale 0N/A * @return the localized name of the object; null if this 0N/A * object does not have a name 0N/A * @see #setAccessibleName 0N/A * Sets the localized accessible name of this object. Changing the 0N/A * name will cause a PropertyChangeEvent to be fired for the 0N/A * ACCESSIBLE_NAME_PROPERTY property. 0N/A * @param s the new localized name of the object. 0N/A * @see #getAccessibleName 0N/A * @see #addPropertyChangeListener 0N/A * description: Sets the accessible name for the component. 0N/A * Gets the accessibleDescription property of this object. The 0N/A * accessibleDescription property of this object is a short localized 0N/A * phrase describing the purpose of the object. For example, in the 0N/A * case of a 'Cancel' button, the accessibleDescription could be 0N/A * 'Ignore changes and close dialog box.' 0N/A * @return the localized description of the object; null if 0N/A * this object does not have a description 0N/A * @see #setAccessibleDescription 0N/A * Sets the accessible description of this object. Changing the 0N/A * name will cause a PropertyChangeEvent to be fired for the 0N/A * ACCESSIBLE_DESCRIPTION_PROPERTY property. 0N/A * @param s the new localized description of the object 0N/A * @see #setAccessibleName 0N/A * @see #addPropertyChangeListener 0N/A * description: Sets the accessible description for the component. 0N/A * Gets the role of this object. The role of the object is the generic 0N/A * purpose or use of the class of this object. For example, the role 0N/A * of a push button is AccessibleRole.PUSH_BUTTON. The roles in 0N/A * AccessibleRole are provided so component developers can pick from 0N/A * a set of predefined roles. This enables assistive technologies to 0N/A * provide a consistent interface to various tweaked subclasses of 0N/A * components (e.g., use AccessibleRole.PUSH_BUTTON for all components 0N/A * that act like a push button) as well as distinguish between sublasses 0N/A * that behave differently (e.g., AccessibleRole.CHECK_BOX for check boxes 0N/A * and AccessibleRole.RADIO_BUTTON for radio buttons). 0N/A * <p>Note that the AccessibleRole class is also extensible, so 0N/A * custom component developers can define their own AccessibleRole's 0N/A * if the set of predefined roles is inadequate. 0N/A * @return an instance of AccessibleRole describing the role of the object 0N/A * @see AccessibleRole 0N/A * Gets the state set of this object. The AccessibleStateSet of an object 0N/A * is composed of a set of unique AccessibleStates. A change in the 0N/A * AccessibleStateSet of an object will cause a PropertyChangeEvent to 0N/A * be fired for the ACCESSIBLE_STATE_PROPERTY property. 0N/A * @return an instance of AccessibleStateSet containing the 0N/A * current state set of the object 0N/A * @see AccessibleStateSet 0N/A * @see AccessibleState 0N/A * @see #addPropertyChangeListener 0N/A * Gets the Accessible parent of this object. 0N/A * @return the Accessible parent of this object; null if this 0N/A * object does not have an Accessible parent 0N/A * Sets the Accessible parent of this object. This is meant to be used 0N/A * only in the situations where the actual component's parent should 0N/A * not be treated as the component's accessible parent and is a method 0N/A * that should only be called by the parent of the accessible child. 0N/A * @param a - Accessible to be set as the parent 0N/A * Gets the 0-based index of this object in its accessible parent. 0N/A * @return the 0-based index of this object in its parent; -1 if this 0N/A * object does not have an accessible parent. 0N/A * @see #getAccessibleParent 0N/A * @see #getAccessibleChildrenCount 0N/A * @see #getAccessibleChild 0N/A * Returns the number of accessible children of the object. 0N/A * @return the number of accessible children of the object. 0N/A * Returns the specified Accessible child of the object. The Accessible 0N/A * children of an Accessible object are zero-based, so the first child 0N/A * of an Accessible child is at index 0, the second child is at index 1, 0N/A * @param i zero-based index of child 0N/A * @return the Accessible child of the object 0N/A * @see #getAccessibleChildrenCount 0N/A * Gets the locale of the component. If the component does not have a 0N/A * locale, then the locale of its parent is returned. 0N/A * @return this component's locale. If this component does not have 0N/A * a locale, the locale of its parent is returned. 0N/A * @exception IllegalComponentStateException 0N/A * If the Component does not have its own locale and has not yet been 0N/A * added to a containment hierarchy such that the locale can be 0N/A * determined from the containing parent. 0N/A * Adds a PropertyChangeListener to the listener list. 0N/A * The listener is registered for all Accessible properties and will 0N/A * be called when those properties change. 0N/A * @see #ACCESSIBLE_NAME_PROPERTY 0N/A * @see #ACCESSIBLE_DESCRIPTION_PROPERTY 0N/A * @see #ACCESSIBLE_STATE_PROPERTY 0N/A * @see #ACCESSIBLE_VALUE_PROPERTY 0N/A * @see #ACCESSIBLE_SELECTION_PROPERTY 0N/A * @see #ACCESSIBLE_TEXT_PROPERTY 0N/A * @see #ACCESSIBLE_VISIBLE_DATA_PROPERTY 0N/A * @param listener The PropertyChangeListener to be added 0N/A * Removes a PropertyChangeListener from the listener list. 0N/A * This removes a PropertyChangeListener that was registered 0N/A * for all properties. 0N/A * @param listener The PropertyChangeListener to be removed 0N/A * Gets the AccessibleAction associated with this object that supports 0N/A * one or more actions. 0N/A * @return AccessibleAction if supported by object; else return null 0N/A * @see AccessibleAction 0N/A * Gets the AccessibleComponent associated with this object that has a 0N/A * graphical representation. 0N/A * @return AccessibleComponent if supported by object; else return null 0N/A * @see AccessibleComponent 0N/A * Gets the AccessibleSelection associated with this object which allows its 0N/A * Accessible children to be selected. 0N/A * @return AccessibleSelection if supported by object; else return null 0N/A * @see AccessibleSelection 0N/A * Gets the AccessibleText associated with this object presenting 0N/A * text on the display. 0N/A * @return AccessibleText if supported by object; else return null 0N/A * @see AccessibleText 0N/A * Gets the AccessibleEditableText associated with this object 0N/A * presenting editable text on the display. 0N/A * @return AccessibleEditableText if supported by object; else return null 0N/A * @see AccessibleEditableText 0N/A * Gets the AccessibleValue associated with this object that supports a 0N/A * @return AccessibleValue if supported by object; else return null 0N/A * @see AccessibleValue 0N/A * Gets the AccessibleIcons associated with an object that has 0N/A * one or more associated icons 0N/A * @return an array of AccessibleIcon if supported by object; 0N/A * otherwise return null 0N/A * @see AccessibleIcon 0N/A * Gets the AccessibleRelationSet associated with an object 0N/A * @return an AccessibleRelationSet if supported by object; 0N/A * otherwise return null 0N/A * @see AccessibleRelationSet 0N/A * Gets the AccessibleTable associated with an object 0N/A * @return an AccessibleTable if supported by object; 0N/A * otherwise return null 0N/A * @see AccessibleTable 0N/A * Support for reporting bound property changes. If oldValue and 0N/A * newValue are not equal and the PropertyChangeEvent listener list 0N/A * is not empty, then fire a PropertyChange event to each listener. 0N/A * In general, this is for use by the Accessible objects themselves 0N/A * and should not be called by an application program. 0N/A * @param propertyName The programmatic name of the property that 0N/A * @param oldValue The old value of the property. 0N/A * @param newValue The new value of the property. 0N/A * @see java.beans.PropertyChangeSupport 0N/A * @see #addPropertyChangeListener 0N/A * @see #removePropertyChangeListener 0N/A * @see #ACCESSIBLE_NAME_PROPERTY 0N/A * @see #ACCESSIBLE_DESCRIPTION_PROPERTY 0N/A * @see #ACCESSIBLE_STATE_PROPERTY 0N/A * @see #ACCESSIBLE_VALUE_PROPERTY 0N/A * @see #ACCESSIBLE_SELECTION_PROPERTY 0N/A * @see #ACCESSIBLE_TEXT_PROPERTY 0N/A * @see #ACCESSIBLE_VISIBLE_DATA_PROPERTY