javax.accessibility
Class AccessibleStateSet

java.lang.Object
  javax.accessibility.AccessibleStateSet

public class AccessibleStateSet
extends Object

Class AccessibleStateSet determines a component's state set. The state set of a component is a set of AccessibleState objects and descriptions. E.G., The current overall state of the object, such as whether it is enabled, has focus, etc.

See Also:

AccessibleState

Field Summary

protected Vector<AccessibleState>

states Each entry in the Vector represents an AccessibleState.

Constructor Summary

AccessibleStateSet()
Creates a new empty state set.

AccessibleStateSet(AccessibleState[] states)
Creates a new state with the initial set of states contained in the array of states passed in.

Method Summary

boolean	add(AccessibleState state) Adds a new state to the current state set if it is not already present.
void	addAll(AccessibleState[] states) Adds all of the states to the existing state set.
void	clear() Removes all the states from the current state set.
boolean	contains(AccessibleState state) Checks if the current state is in the state set.
boolean	remove(AccessibleState state) Removes a state from the current state set.
AccessibleState[]	toArray() Returns the current state set as an array of AccessibleState
String	toString() Creates a localized String representing all the states in the set using the default locale.

Methods inherited from class java.lang.Object

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

Field Detail

states

protected Vector<AccessibleState> states

Each entry in the Vector represents an AccessibleState.

See Also:

add(javax.accessibility.AccessibleState), addAll(javax.accessibility.AccessibleState[]), remove(javax.accessibility.AccessibleState), contains(javax.accessibility.AccessibleState), toArray(), clear()

Constructor Detail

AccessibleStateSet

public AccessibleStateSet()

Creates a new empty state set.

AccessibleStateSet

public AccessibleStateSet(AccessibleState[] states)

Creates a new state with the initial set of states contained in the array of states passed in. Duplicate entries are ignored.

Parameters:

states - an array of AccessibleState describing the state set.

Method Detail

add

public boolean add(AccessibleState state)

Adds a new state to the current state set if it is not already present. If the state is already in the state set, the state set is unchanged and the return value is false. Otherwise, the state is added to the state set and the return value is true.

Parameters:

state - the state to add to the state set

Returns:

true if state is added to the state set; false if the state set is unchanged

addAll

public void addAll(AccessibleState[] states)

Adds all of the states to the existing state set. Duplicate entries are ignored.

Parameters:

states - AccessibleState array describing the state set.

remove

public boolean remove(AccessibleState state)

Removes a state from the current state set. If the state is not in the set, the state set will be unchanged and the return value will be false. If the state is in the state set, it will be removed from the set and the return value will be true.

Parameters:

state - the state to remove from the state set

Returns:

true if the state is in the state set; false if the state set will be unchanged

clear

public void clear()

Removes all the states from the current state set.

contains

public boolean contains(AccessibleState state)

Checks if the current state is in the state set.

Parameters:

state - the state

Returns:

true if the state is in the state set; otherwise false

toArray

public AccessibleState[] toArray()

Returns the current state set as an array of AccessibleState

Returns:

AccessibleState array containing the current state.

toString

public String toString()

Creates a localized String representing all the states in the set using the default locale.

Overrides:

toString in class Object

Returns:

comma separated localized String

See Also:

AccessibleBundle.toDisplayString(java.lang.String, java.util.Locale)