Class AccessibleState describes a component's particular state. The actual
state of the component is defined as an AccessibleStateSet, which is a
composed set of AccessibleStates.
The toDisplayString method allows you to obtain the localized string
for a locale independent key from a predefined ResourceBundle for the
keys defined in this class.
The constants in this class present a strongly typed enumeration
of common object roles. A public constructor for this class has been
purposely omitted and applications should use one of the constants
from this class. If the constants in this class are not sufficient
to describe the role of an object, a subclass should be generated
from this class and it should provide constants in a similar manner.
version: 1.45 05/05/07 author: Willie Walker author: Peter Korn
FOCUSABLE Indicates this object can accept keyboard focus, which means all
events resulting from typing on the keyboard will normally be
passed to it when it has focus.
SELECTABLE Indicates this object is the child of an object that allows its
children to be selected, and that this child is one of those
children that can be selected.
SELECTED Indicates this object is the child of an object that allows its
children to be selected, and that this child is one of those
children that has been selected.
Indicates a window is currently the active window. This includes
windows, dialogs, frames, etc. In addition, this state is used
to indicate the currently active child of a component such as a
list, table, or tree. For example, the active child of a list
is the child that is drawn with a rectangle around it.
See Also:AccessibleRole.WINDOW See Also:AccessibleRole.FRAME See Also:AccessibleRole.DIALOG
Indicates that the object is armed. This is usually used on buttons
that have been pressed but not yet released, and the mouse pointer
is still over the button.
See Also:AccessibleRole.PUSH_BUTTON
Indicates the user can change the contents of this object. This
is usually used primarily for objects that allow the user to
enter text. Other objects, such as scroll bars and sliders,
are automatically editable if they are enabled.
See Also:AccessibleState.ENABLED
Indicates this object is enabled. The absence of this state from an
object's state set indicates this object is not enabled. An object
that is not enabled cannot be manipulated by the user. In a graphical
display, it is usually grayed out.
Indicates this object allows progressive disclosure of its children.
This is usually used with hierarchical objects such as trees and
is often paired with the EXPANDED or COLLAPSED states.
See Also:AccessibleState.EXPANDED See Also:AccessibleState.COLLAPSED See Also:AccessibleRole.TREE
Indicates this object can accept keyboard focus, which means all
events resulting from typing on the keyboard will normally be
passed to it when it has focus.
See Also:AccessibleState.FOCUSED
Indicates this object is minimized and is represented only by an
icon. This is usually only associated with frames and internal
frames.
See Also:AccessibleRole.FRAME See Also:AccessibleRole.INTERNAL_FRAME
Indicates that the object state is indeterminate. An example
is selected text that is partially bold and partially not
bold. In this case the attributes associated with the selected
text are indeterminate.
since: 1.5
Indicates this object is responsible for managing its
subcomponents. This is typically used for trees and tables
that have a large number of subcomponents and where the
objects are created only when needed and otherwise remain virtual.
The application should not manage the subcomponents directly.
since: 1.5
Indicates something must be done with this object before the
user can interact with an object in a different window. This
is usually associated only with dialogs.
See Also:AccessibleRole.DIALOG
Indicates this object paints every pixel within its
rectangular region. A non-opaque component paints only some of
its pixels, allowing the pixels underneath it to "show through".
A component that does not fully paint its pixels therefore
provides a degree of transparency.
See Also:Accessible.getAccessibleContext See Also:AccessibleContext.getAccessibleComponent See Also:AccessibleComponent.getBounds
Indicates this object is currently pressed. This is usually
associated with buttons and indicates the user has pressed a
mouse button while the pointer was over the button and has
not yet released the mouse button.
See Also:AccessibleRole.PUSH_BUTTON
Indicates this object, the object's parent, the object's parent's
parent, and so on, are all visible. Note that this does not
necessarily mean the object is painted on the screen. It might
be occluded by some other showing object.
See Also:AccessibleState.VISIBLE
Indicates this object is transient. An assistive technology should
not add a PropertyChange listener to an object with transient state,
as that object will never generate any events. Transient objects
are typically created to answer Java Accessibility method queries,
but otherwise do not remain linked to the underlying object (for
example, those objects underneath lists, tables, and trees in Swing,
where only one actual UI Component does shared rendering duty for
all of the data objects underneath the actual list/table/tree elements).
since: 1.5
A state indicating that text is truncated by a bounding rectangle
and that some of the text is not displayed on the screen. An example
is text in a spreadsheet cell that is truncated by the bounds of
the cell.
since: 1.5
Indicates this object is visible. Note: this means that the
object intends to be visible; however, it may not in fact be
showing on the screen because one of the objects that this object
is contained by is not visible.
See Also:AccessibleState.SHOWING
Creates a new AccessibleState using the given locale independent key.
This should not be a public method. Instead, it is used to create
the constants in this file to make it a strongly typed enumeration.
Subclasses of this class should enforce similar policy.
The key String should be a locale independent key for the state.
It is not intended to be used as the actual String to display
to the user. To get the localized string, use toDisplayString.
Parameters: key - the locale independent name of the state. See Also:AccessibleBundle.toDisplayString
Fields inherited from javax.accessibility.AccessibleBundle