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

Fields

Modifier and Type	Field	Description
protected Vector<AccessibleState>	states	Each entry in the Vector represents an AccessibleState.

Constructor Summary

Constructors

Constructor	Description
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

Modifier and Type	Method	Description
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 declared in class Object

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

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode()	Answers an integer hash code for the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Field Details

states

protected Vector<AccessibleState> states

Each entry in the Vector represents an AccessibleState.

See Also:

• add(AccessibleState)
• addAll(AccessibleState[])
• remove(AccessibleState)
• contains(AccessibleState)
• toArray()
• clear()

Constructor Details

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 Details

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(String, Locale)