Component.AccessibleAWTComponent
, ImageIcon.AccessibleImageIcon
, JList.AccessibleJList.AccessibleJListChild
, JTable.AccessibleJTable.AccessibleJTableCell
, JTableHeader.AccessibleJTableHeader.AccessibleJTableHeaderEntry
, JTree.AccessibleJTree.AccessibleJTreeNode
, MenuComponent.AccessibleAWTMenuComponent
, ProgressMonitor.AccessibleProgressMonitor
, Translator
@JavaBean(description="Minimal information that all accessible objects return") public abstract class AccessibleContext extends Object
AccessibleContext
represents the minimum information all accessible objects return. This information includes the accessible name, description, role, and state of the object, as well as information about its parent and children. AccessibleContext
also contains methods for obtaining more specific accessibility information about a component. If the component supports them, these methods will return an object that implements one or more of the following interfaces: AccessibleAction
- the object can perform one or more actions. This interface provides the standard mechanism for an assistive technology to determine what those actions are and tell the object to perform them. Any object that can be manipulated should support this interface. AccessibleComponent
- the object has a graphical representation. This interface provides the standard mechanism for an assistive technology to determine and set the graphical representation of the object. Any object that is rendered on the screen should support this interface. AccessibleSelection
- the object allows its children to be selected. This interface provides the standard mechanism for an assistive technology to determine the currently selected children of the object as well as modify its selection set. Any object that has children that can be selected should support this interface. AccessibleText
- the object presents editable textual information on the display. This interface provides the standard mechanism for an assistive technology to access that text via its content, attributes, and spatial location. Any object that contains editable text should support this interface. AccessibleValue
- the object supports a numerical value. This interface provides the standard mechanism for an assistive technology to determine and set the current value of the object, as well as obtain its minimum and maximum values. Any object that supports a numerical value should support this interface. Modifier and Type | Field | Description |
---|---|---|
static final String |
ACCESSIBLE_ACTION_PROPERTY |
Constant used to indicate that the supported set of actions has changed. |
static final String |
ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY |
Constant used to determine when the active descendant of a component has changed. |
static final String |
ACCESSIBLE_CARET_PROPERTY |
Constant used to determine when the accessibleText caret has changed. |
static final String |
ACCESSIBLE_CHILD_PROPERTY |
Constant used to determine when Accessible children are added/removed from the object. |
static final String |
ACCESSIBLE_COMPONENT_BOUNDS_CHANGED |
PropertyChangeEvent which indicates that a change has occurred in a component's bounds. |
static final String |
ACCESSIBLE_DESCRIPTION_PROPERTY |
Constant used to determine when the accessibleDescription property has changed. |
static final String |
ACCESSIBLE_HYPERTEXT_OFFSET |
Constant used to indicate that a hypertext element has received focus. |
static final String |
ACCESSIBLE_INVALIDATE_CHILDREN |
PropertyChangeEvent which indicates that a significant change has occurred to the children of a component like a tree or text. |
static final String |
ACCESSIBLE_NAME_PROPERTY |
Constant used to determine when the accessibleName property has changed. |
static final String |
ACCESSIBLE_SELECTION_PROPERTY |
Constant used to determine when the accessibleSelection has changed. |
static final String |
ACCESSIBLE_STATE_PROPERTY |
Constant used to determine when the accessibleStateSet property has changed. |
static final String |
ACCESSIBLE_TABLE_CAPTION_CHANGED |
Constant used to indicate that the table caption has changed. |
static final String |
ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED |
Constant used to indicate that the column description has changed. |
static final String |
ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED |
Constant used to indicate that the column header has changed. |
static final String |
ACCESSIBLE_TABLE_MODEL_CHANGED |
Constant used to indicate that table data has changed. |
static final String |
ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED |
Constant used to indicate that the row description has changed. |
static final String |
ACCESSIBLE_TABLE_ROW_HEADER_CHANGED |
Constant used to indicate that the row header has changed. |
static final String |
ACCESSIBLE_TABLE_SUMMARY_CHANGED |
Constant used to indicate that the table summary has changed. |
static final String |
ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED |
PropertyChangeEvent which indicates that text attributes have changed. |
static final String |
ACCESSIBLE_TEXT_PROPERTY |
PropertyChangeEvent which indicates that text has changed. |
static final String |
ACCESSIBLE_VALUE_PROPERTY |
Constant used to determine when the accessibleValue property has changed. |
static final String |
ACCESSIBLE_VISIBLE_DATA_PROPERTY |
Constant used to determine when the visual appearance of the object has changed. |
protected String |
accessibleDescription |
A localized String containing the description of the object. |
protected String |
accessibleName |
A localized String containing the name of the object. |
protected Accessible |
accessibleParent |
The accessible parent of this object. |
Modifier | Constructor | Description |
---|---|---|
protected |
Constructor for subclasses to call. |
Modifier and Type | Method | Description |
---|---|---|
void |
addPropertyChangeListener |
Adds a PropertyChangeListener to the listener list. |
void |
firePropertyChange |
Support for reporting bound property changes. |
AccessibleAction |
getAccessibleAction() |
Gets the AccessibleAction associated with this object that supports one or more actions. |
abstract Accessible |
getAccessibleChild |
Returns the specified Accessible child of the object. |
abstract int |
getAccessibleChildrenCount() |
Returns the number of accessible children of the object. |
AccessibleComponent |
getAccessibleComponent() |
Gets the AccessibleComponent associated with this object that has a graphical representation. |
String |
getAccessibleDescription() |
Gets the accessibleDescription property of this object. |
AccessibleEditableText |
getAccessibleEditableText() |
Gets the AccessibleEditableText associated with this object presenting editable text on the display. |
AccessibleIcon[] |
getAccessibleIcon() |
Gets the AccessibleIcons associated with an object that has one or more associated icons. |
abstract int |
getAccessibleIndexInParent() |
Gets the 0-based index of this object in its accessible parent. |
String |
getAccessibleName() |
Gets the accessibleName property of this object. |
Accessible |
getAccessibleParent() |
Gets the Accessible parent of this object. |
AccessibleRelationSet |
getAccessibleRelationSet() |
Gets the AccessibleRelationSet associated with an object. |
abstract AccessibleRole |
getAccessibleRole() |
Gets the role of this object. |
AccessibleSelection |
getAccessibleSelection() |
Gets the AccessibleSelection associated with this object which allows its Accessible children to be selected. |
abstract AccessibleStateSet |
getAccessibleStateSet() |
Gets the state set of this object. |
AccessibleTable |
getAccessibleTable() |
Gets the AccessibleTable associated with an object. |
AccessibleText |
getAccessibleText() |
Gets the AccessibleText associated with this object presenting text on the display. |
AccessibleValue |
getAccessibleValue() |
Gets the AccessibleValue associated with this object that supports a Numerical value. |
abstract Locale |
getLocale() |
Gets the locale of the component. |
void |
removePropertyChangeListener |
Removes a PropertyChangeListener from the listener list. |
void |
setAccessibleDescription |
Sets the accessible description of this object. |
void |
setAccessibleName |
Sets the localized accessible name of this object. |
void |
setAccessibleParent |
Sets the Accessible parent of this object. |
public static final String ACCESSIBLE_NAME_PROPERTY
accessibleName
property has changed. The old value in the PropertyChangeEvent
will be the old accessibleName
and the new value will be the new accessibleName
.public static final String ACCESSIBLE_DESCRIPTION_PROPERTY
accessibleDescription
property has changed. The old value in the PropertyChangeEvent
will be the old accessibleDescription
and the new value will be the new accessibleDescription
.public static final String ACCESSIBLE_STATE_PROPERTY
accessibleStateSet
property has changed. The old value will be the old AccessibleState
and the new value will be the new AccessibleState
in the accessibleStateSet
. For example, if a component that supports the vertical and horizontal states changes its orientation from vertical to horizontal, the old value will be AccessibleState.VERTICAL
and the new value will be AccessibleState.HORIZONTAL
. Please note that either value can also be null
. For example, when a component changes from being enabled to disabled, the old value will be AccessibleState.ENABLED
and the new value will be null
.public static final String ACCESSIBLE_VALUE_PROPERTY
accessibleValue
property has changed. The old value in the PropertyChangeEvent
will be a Number
representing the old value and the new value will be a Number
representing the new value.public static final String ACCESSIBLE_SELECTION_PROPERTY
accessibleSelection
has changed. The old and new values in the PropertyChangeEvent
are currently reserved for future use.public static final String ACCESSIBLE_CARET_PROPERTY
accessibleText
caret has changed. The old value in the PropertyChangeEvent
will be an integer representing the old caret position, and the new value will be an integer representing the new/current caret position.public static final String ACCESSIBLE_VISIBLE_DATA_PROPERTY
PropertyChangeEvent
are currently reserved for future use.public static final String ACCESSIBLE_CHILD_PROPERTY
Accessible
children are added/removed from the object. If an Accessible
child is being added, the old value will be null
and the new value will be the Accessible
child. If an Accessible
child is being removed, the old value will be the Accessible
child, and the new value will be null
.public static final String ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY
Accessible
representing the previous active child, and the new value will be the Accessible
representing the current active child.public static final String ACCESSIBLE_TABLE_CAPTION_CHANGED
PropertyChangeEvent
will be an Accessible
representing the previous table caption and the new value will be an Accessible
representing the new table caption.public static final String ACCESSIBLE_TABLE_SUMMARY_CHANGED
PropertyChangeEvent
will be an Accessible
representing the previous table summary and the new value will be an Accessible
representing the new table summary.public static final String ACCESSIBLE_TABLE_MODEL_CHANGED
PropertyChangeEvent
will be null
and the new value will be an AccessibleTableModelChange
representing the table change.public static final String ACCESSIBLE_TABLE_ROW_HEADER_CHANGED
PropertyChangeEvent
will be null
and the new value will be an AccessibleTableModelChange
representing the header change.public static final String ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED
PropertyChangeEvent
will be null
and the new value will be an Integer
representing the row index.public static final String ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED
PropertyChangeEvent
will be null
and the new value will be an AccessibleTableModelChange
representing the header change.public static final String ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED
PropertyChangeEvent
will be null
and the new value will be an Integer
representing the column index.public static final String ACCESSIBLE_ACTION_PROPERTY
PropertyChangeEvent
will be an Integer
representing the old number of actions supported and the new value will be an Integer
representing the new number of actions supported.public static final String ACCESSIBLE_HYPERTEXT_OFFSET
PropertyChangeEvent
will be an Integer
representing the start index in the document of the previous element that had focus and the new value will be an Integer
representing the start index in the document of the current element that has focus. A value of -1 indicates that an element does not or did not have focus.public static final String ACCESSIBLE_TEXT_PROPERTY
PropertyChangeEvent
which indicates that text has changed. oldValue
is null
and the newValue
is an AccessibleTextSequence
specifying the text that was inserted. oldValue
is an AccessibleTextSequence
specifying the text that was deleted and the newValue
is null
. oldValue
is an AccessibleTextSequence
specifying the old text and the newValue
is an AccessibleTextSequence
specifying the new text.public static final String ACCESSIBLE_INVALIDATE_CHILDREN
PropertyChangeEvent
which indicates that a significant change has occurred to the children of a component like a tree or text. This change notifies the event listener that it needs to reacquire the state of the subcomponents. The oldValue
is null
and the newValue
is the component whose children have become invalid.public static final String ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED
PropertyChangeEvent
which indicates that text attributes have changed. oldValue
is null
and the newValue
is an AccessibleAttributeSequence
specifying the attributes that were inserted. oldValue
is an AccessibleAttributeSequence
specifying the attributes that were deleted and the newValue
is null
. oldValue
is an AccessibleAttributeSequence
specifying the old attributes and the newValue
is an AccessibleAttributeSequence
specifying the new attributes.public static final String ACCESSIBLE_COMPONENT_BOUNDS_CHANGED
PropertyChangeEvent
which indicates that a change has occurred in a component's bounds. The oldValue
is the old component bounds and the newValue
is the new component bounds.protected Accessible accessibleParent
protected String accessibleName
protected String accessibleDescription
protected AccessibleContext()
public String getAccessibleName()
accessibleName
property of this object. The accessibleName
property of an object is a localized String
that designates the purpose of the object. For example, the accessibleName
property of a label or button might be the text of the label or button itself. In the case of an object that doesn't display its name, the accessibleName
should still be set. For example, in the case of a text field used to enter the name of a city, the accessibleName
for the en_US
locale could be 'city.'null
if this object does not have a name@BeanProperty(preferred=true, description="Sets the accessible name for the component.") public void setAccessibleName(String s)
PropertyChangeEvent
to be fired for the ACCESSIBLE_NAME_PROPERTY
property.s
- the new localized name of the objectpublic String getAccessibleDescription()
accessibleDescription
property of this object. The accessibleDescription
property of this object is a short localized phrase describing the purpose of the object. For example, in the case of a 'Cancel' button, the accessibleDescription
could be 'Ignore changes and close dialog box.'null
if this object does not have a description@BeanProperty(preferred=true, description="Sets the accessible description for the component.") public void setAccessibleDescription(String s)
PropertyChangeEvent
to be fired for the ACCESSIBLE_DESCRIPTION_PROPERTY
property.s
- the new localized description of the objectpublic abstract AccessibleRole getAccessibleRole()
AccessibleRole.PUSH_BUTTON
. The roles in AccessibleRole
are provided so component developers can pick from a set of predefined roles. This enables assistive technologies to provide a consistent interface to various tweaked subclasses of components (e.g., use AccessibleRole.PUSH_BUTTON
for all components that act like a push button) as well as distinguish between subclasses that behave differently (e.g., AccessibleRole.CHECK_BOX
for check boxes and AccessibleRole.RADIO_BUTTON
for radio buttons). Note that the AccessibleRole
class is also extensible, so custom component developers can define their own AccessibleRole
's if the set of predefined roles is inadequate.
AccessibleRole
describing the role of the objectpublic abstract AccessibleStateSet getAccessibleStateSet()
AccessibleStateSet
of an object is composed of a set of unique AccessibleStates
. A change in the AccessibleStateSet
of an object will cause a PropertyChangeEvent
to be fired for the ACCESSIBLE_STATE_PROPERTY
property.AccessibleStateSet
containing the current state set of the objectpublic Accessible getAccessibleParent()
Accessible
parent of this object.Accessible
parent of this object; null
if this object does not have an Accessible
parentpublic void setAccessibleParent(Accessible a)
Accessible
parent of this object. This is meant to be used only in the situations where the actual component's parent should not be treated as the component's accessible parent and is a method that should only be called by the parent of the accessible child.a
- Accessible
to be set as the parentpublic abstract int getAccessibleIndexInParent()
public abstract int getAccessibleChildrenCount()
public abstract Accessible getAccessibleChild(int i)
Accessible
child of the object. The Accessible
children of an Accessible
object are zero-based, so the first child of an Accessible
child is at index 0, the second child is at index 1, and so on.i
- zero-based index of childAccessible
child of the objectpublic abstract Locale getLocale() throws IllegalComponentStateException
IllegalComponentStateException
- If the component does not have its own locale and has not yet been added to a containment hierarchy such that the locale can be determined from the containing parentpublic void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
to the listener list. The listener is registered for all Accessible
properties and will be called when those properties change.listener
- The PropertyChangeListener to be addedpublic void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
from the listener list. This removes a PropertyChangeListener
that was registered for all properties.listener
- The PropertyChangeListener to be removedpublic AccessibleAction getAccessibleAction()
AccessibleAction
associated with this object that supports one or more actions.AccessibleAction
if supported by object; else return null
public AccessibleComponent getAccessibleComponent()
AccessibleComponent
associated with this object that has a graphical representation.AccessibleComponent
if supported by object; else return null
public AccessibleSelection getAccessibleSelection()
AccessibleSelection
associated with this object which allows its Accessible
children to be selected.AccessibleSelection
if supported by object; else return null
public AccessibleText getAccessibleText()
AccessibleText
associated with this object presenting text on the display.AccessibleText
if supported by object; else return null
public AccessibleEditableText getAccessibleEditableText()
AccessibleEditableText
associated with this object presenting editable text on the display.AccessibleEditableText
if supported by object; else return null
public AccessibleValue getAccessibleValue()
AccessibleValue
associated with this object that supports a Numerical
value.AccessibleValue
if supported by object; else return null
public AccessibleIcon[] getAccessibleIcon()
AccessibleIcons
associated with an object that has one or more associated icons.AccessibleIcon
if supported by object; otherwise return null
public AccessibleRelationSet getAccessibleRelationSet()
AccessibleRelationSet
associated with an object.AccessibleRelationSet
if supported by object; otherwise return null
public AccessibleTable getAccessibleTable()
AccessibleTable
associated with an object.AccessibleTable
if supported by object; otherwise return null
public void firePropertyChange(String propertyName, Object oldValue, Object newValue)
oldValue
and newValue
are not equal and the PropertyChangeEvent
listener list is not empty, then fire a PropertyChange
event to each listener. In general, this is for use by the Accessible
objects themselves and should not be called by an application program.propertyName
- The programmatic name of the property that was changedoldValue
- The old value of the propertynewValue
- The new value of the property
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/accessibility/AccessibleContext.html