JavaTM 2 Platform
Std. Ed. v1.4.0

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 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 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.

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.


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)

JavaTM 2 Platform
Std. Ed. v1.4.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.